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В днешно време създаването на съдържание в интернет става все 
по-популярно и се превръща в ежедневие за много хора. С издигането на 
социалните мрежи за предимно аудио и видео споделяне като УочТибе, 
б5ро|Щу, | пзтадгага и ТКТок, все повече хора създават видеа и подкасти, а 
те се нуждаят от техника и места за записване. 

Качеството на една продукция е от изключително значение за 
достигането до търсената аудитория. Една част от качеството се изгражда 
именно от техниката, използвана при създаването на съдържание за 
социалните мрежи. Тя играе ключова роля във възприемането на 
крайния резултат. 

Също така, не трябва да се подценява и важността на местата, на 
които се снима. Локациите играят решаваща роля във визуалното 
излъчване на създаденото. Независимо дали става въпрос за студио с 
професионално осветление, уникални интериори или живописни 
пейзажи на открито, правилният избор на място допринася за естетиката 
и атмосферата на качественото съдържание. 

Този дипломен проект - "епзепЯ", представлява адаптивно 
динамично уеб приложение, насочено към хора, които желаят да създават 
дигитално съдържание за интернет. Платформата предоставя онлайн 
обяви за търсене и предлагане на снимачно и аудио оборудване, както и 
за предлагане на локации за снимане на съдържание. Целта на 
“епзГепа" е да улесни процеса на създаване на съдържание, 
предоставяйки достъпна от всяко устройство уеб платформа за намиране 
на необходимата техника и подходящи места за снимане на снимки, 


видеа и подкасти. 


Глава | 


Подходи за създаване на платформата и проучване 


на подобни системи 


11. Предимства на уеб приложенията 


Уеб приложенията предлагат редица ключови предимства, които ги 
правят популярен избор за разработчици и потребители на онлайн 
софтуер. Предимствата за разработка на уеб приложение, за разлика от 
създаване на едноплатформено или многоплатформено мобилно 
приложение, е, че продуктът е достъпен на всякакви устройства, тъй като 
има ниво на абстракция - уеб браузър. Всяко устройство с достъп до 
интернет и уеб браузър може да достъпи уеб приложението без нуждата 
от инсталиране на допълнителен софтуер. Уеб приложенията също се 
актуализират централизирано, което означава, че всички потребители 
винаги използват най-новата версия без нужда от ръчно обновяване. Те 
са скалируеми и могат лесно да се адаптират към растящия брой 
потребители и променящите се бизнес изисквания. Разработката и 
поддръжката на уеб приложения често изисква по-малко време и 
ресурси в сравнение с традиционния модел на поддръжка на 2 мобилни 
приложения (Апаго!й и 109) и уебсайт. 

Като платформа за покупко-продажба, която постоянно се нуждае от 
връзка с интернет и минимално съхранение на локални данни, 
предимствата, които > мобилните > приложения > предлагат, “като 
допълнителна производителност и офлайн достъп до съдържание, не са 


от първа необходимост. 


12. Съществуващи решения и реализации на пазара 
121. ОХ - платформа за онлайн покупко-продажба между 


потребители 


ОЩХ е най-популярната онлайн платформа за онлайн покупко- 
продажба на стоки втора ръка от всякакъв вид в България и на Балканите. 
Тя разполага както с уеб приложение (фиг. 1.1.), така и с мобилни 
приложения (фиг. 1.2.) за двете най-големи платформи - Апагой и 105. 
Платформата е локализирана както на български, така и на английски 
език. Разполага с прост, модерен и чист потребителски интерфейс, в 
който могат да се публикуват обяви в набор от категории. О! Х също дава 
възможност на потребителите да запазват любимите си обяви, да търсят 
обяви и да общуват с останалите потребители в платформата чрез тяхна 


чат система. 


ОХ - Купувай и продавай 
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1.2 2. Базар.БГ" - платформа за онлайн покупко-продажба между 


потребители 


Базар.БГ е българска разработка и конкуренция на платформата 
ОХ. За разлика от ОХ, тя разполага с неограничен (безплатен) достъп до 
публикуване на обяви. Въпреки че е със сравнително остарял 
интерфейс", тя продължава да е второто най-посещавано място от 
българи при търсене и продаване на стоки втора ръка онлайн, тъй като 
предоставя безплатни услуги на по-централизирано място от обикновен 


форум. 
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# Подарявам г Петъчен Базар - ден за разпродажби! Доставки с бонус! 
О ииаа „3341 оферти иа 


Черно дамско сабо на плат. Фризер Беко 1Соп пробиотик + ПОДАРЪ..  Сатенена пижама Мсопаз 
20 по гу БОП по га азап по гз ба 00 по сз 


фиг. 1.4. - Уебсайт Базар.ЬГ 


ка 


Въпреки това, сред социалните мрежи може да се забележи как ОХ 
има монопол над съзнанието на потребителите на пазара за онлайн 
продажби на употребявани стоки, бивайки предпочитан от над 8290 от 


българските интернет потребители“. 


#7ъ фъшаапа 
ез 6 героу1560 


О!х.рд или ВагагЬа 


« Кое от двете предпочитате повече и защо? 


Ох. Ба 


Вагагра 


фиг. 1.5. - примерно проучване с гласуване в онлайн платформата Кедай за 


предпочитание между ОХ.р9 или Базар.ЬГ 


1.24, Еасероок групи за препоръчване на места за снимане и 


продаване и предлагане под наем на оборудване 


Често срещано решение на много фотографски проблеми са 
Расероок групите (фиг. 1.6.), които от една страна ги решават, като събират 
хората на едно място, но от друга страна ги затрудняват изключително 
много, ако не са техни членове или не са регистрирани в социалната 


мрежа, за да използват нейната вътрешна търсачка. 


Фото Техника - Купува/Продава 
Уоиг дгоир 
Фото техника Купува-продава 
оцг агоир 
Фототехника, оптика, осветление 
и печат - (Купува, Продава,... 
Хоиг дгочр 
ФОТО БАЗАР ++ + 


Уошг агоир 


ототехника Купува Продава 
дгоир 


О4 форум филм българия 


р фото и видео техника 
оиг дгочр 


фиг. 1.6. - Топ 7 резултата в платформата Еасебоок за търсене "фото" 


Затова една от целите на дипломната работа е да позволява на 


търсачките като Соод!е, Впа, Вгаме, ОискОискОо и други да събират 


Зе 


данни и т.нар. метаинформация“, която след това показват на своите 
потребители, когато търсят даден продукт или място. Това е 
изключително благоприятно за както начинаещи, така и за хора, които не 
са толкова запознати с интернет. От друга страна спестява много време 


търсене на и в частни ЕасеБоок групи. 


1.3. Методи за разработка на уеб приложение 


Уеб приложението е приложение, състоящо се от поне две части - 
клиент, който обикновено бива уеб браузър или обвивка на такъв, и 
сървър. Те си комуникират чрез интернет по различни протоколи - 
НТТР(5)М, Муерзоскетс”, акРС“" и други. 

Има три основни вида архитектури, определени според няколко 
критерия - потребителско изживяване, скорост на разработване, 


бързодействие и оптимизации за търсачките - 5ЕО“ като те са следните: 


151. Статичен уебсайт“ 


Статичните уебсайтове са популярни и удобни за употреба за 
новинарски сайтове, блогове, страници на компании и лични портфолиа, 
където информацията за дадена страница не се променя често. Те са 
първата технология, използвана за уеб страници, в началото на интернет. 
В сървър се съхраняват статични файлове като НТМГ., С55, снимки и на по- 
късен етап - 25 (1амазспр!). Те са изключително леки за всички устройства, 
включени в уеб протокола - за клиенти, тъй като получават готови 
страници за показване, за сървърите, тъй като те трябва само да 
съхраняват файлове и за преносната среда, тъй тези файлове са 


изключително малки. Тези страници обикновено се зареждат бързо, са 


пра 


лесни за разработка и поддръжка и не изискват сложна сървърна логика 
или бази данни. 

Въпреки всички тези позитиви, статичните уебсайтове са с 
ограничена интерактивност, а когато не са, се изисква презареждане на 
страници или усложняване на първоначалната архитектура както на 
клиента, така и на сървъра. 

В последно време се използват и много модерни технологии, които 
обикновено се използват за създаване на сървърен уебсайт или уеб 
приложение с една страница, за създаване и генериране на статични уеб 
страници и сайтове. Този вид разработка позволява както ускорение на 
създаването на такива страници (примерно от база данни) чрез 


автоматизация. 
1.5.2. Сървърен (динамичен) уебсайт“ 


При сървърните уебсайтове (познати още като динамични или 
сървърно-изобразени“) позволява на уеб страниците да се генерират в 
реално време в отговор на заявки от потребителя. Това се постига чрез 
използване на сървърни езици като РНР, РуШоп (с Цапдо, Назк), Вибу (с 
Виру оп Ва!з), СЕ (с А5Р.МЕТ) или Замазспр: (с Моде.5), които работят 


заедно с база данни за динамично създаване на съдържание и страници. 


Ков, сааваи Бр Чоро-цур е 


Сталчамо оуамалмо Сталчлмо бумомилио Сталчлмо мо милсмо 


- | со. В ЕБЕ 


С ърхацичето Сацъфивинато са, Чустайдт се. статъсова. Коцех се муйбра- Спромарта, час Уил Арма тек- 
ф ф от от фадада, - МТМ „СЪ „ Стеодас ) Ъ Про злолад, СУХ остава, Могзлиъ Те, цгуге - 
ОН ТОИ 9 ср ондмре рескъдиа 9 (меко Црема. вт Стутчнеив месия. ае курс декове 
Мо, СДрОМАВСТО. (ЛА илц Бед, ако сефивро. ду, с. уж бемтлла. Ма. илале (ом, табизет 

Саид пуаЗбм.ь, тотребъхета, слрчочиие 


“С -Содал Мантуа бархен # пхрчлево “он 


А сметеале. Тук упрабаабама ча Оъррзевоцаме, 
фиг. 1.7. - Схема на работа на статично и динамично (и техните разлики ) 
изобразяване на уебсайт - свързано с точки 1.3.1. и 1.3.2. 


„15 


1.3.5. Уеб приложение с една страница“" 


Разработването на приложения с една страница (5РА) е метод, при 
който уеб приложението зарежда една НТМГ страница и динамично 
актуализира тази страница при взаимодействие с потребителя. 5РА 
използва софтуерни рамки или библиотеки за Замабспр! или Турезспрт 
като Апашаг, Неаси5 или Мие.5 за създаване на приложения с богата 
потребителска интерактивност и производителност, като по този начин 
се подобрява потребителското изживяване и се увеличава бързината на 
приложението, тъй като не се изисква презареждане на страницата при 


промяна на екран, действие или получаване на нови данни. 


МРА5 


фиг. 1.8. - Сравнение между едностранично и многостранично приложения 


Този тип приложения най-често прави заявки за данни от уеб 
браузъра на клиента към ВЕЗТ или СгарнОГ АР! и вместо да съхранява 
данни на сървъра, те най-често се съхраняват локално при клиента. 
Проблеми при приложенията от тип „Една страница“ са, че не са много 
оптимални за 5ЕО, както и за лимитирани откъм ресурси устройства, 
поради големия им размер и нуждата всяко приложение да се 


изобразява и генерира (гепдег) на локалното устройство. 


1.35.4. Разработка на модерно хибридно уеб приложение 


Хибридната уеб разработка представлява съчетание от сървърно 


генерирано съдържание (5589) и клиентска интерактивност чрез 


И РА 


клиентски компоненти (С5В), което позволява на разработчиците да 
изграждат уеб приложения, оптимизирани както за бързина, така и за 
потребителско изживяване. Този подход е особено подходящ за 
създаването на динамични уеб приложения, които се нуждаят от бързо 
зареждане на първоначалната страница, както и от богати интерактивни 
функции на клиентската страна. 

Популярността на този вид уеб приложения започва с излизането на 
тестовата функционалност на Мех 5 15 през 2022г. за създаване на уеб 
приложение с компоненти, които се генерират на сървъра (5егмег 


Согпропепт!з), и тяхното съчетаване с клиентски такива. 


фиг. 1.9. - Изображение показващо двете различни среди на изобразяване на 


уеб приложение (клиент и сървър) 


Сървърните компоненти се използват за динамично генериране на 
съдържание от сървъра, което позволява бързо първоначално зареждане 
и подобрена 5ЕО оптимизация, тъй като съдържанието е вече генерирано 
и изобразено (гепдегед) при достъп от търсачките. Те често се използват 
за неинтерактивните компоненти, които обикновено са пълни със 
съдържание. Клиентските компоненти позволяват богата интерактивност 
и динамично потребителско изживяване, като се зареждат и изпълняват 
директно в браузъра на потребителя. Те биват използвани за бутони и 
компоненти, които зависят от приложно-програмните интерфейси на 


браузърите. 


315- 


Тяхната комбинация се използва за създаване на т.нар. хибридни 
уеб приложения, които обединяват най-доброто от двете среди - бързина 
и оптимизация от сървърните уебсайтове и интерактивността на уеб 
приложенията с една страница. Изборът между тях зависи от конкретните 
нужди на приложението, като целта е да се постигне оптимално 
балансирано решение. 

Въпреки че са сравнително по-сложни за разработка както от 
динамичен сървърен уебсайт, така и от уеб приложение с една страница, 
поради нуждата от съображения за предаване на информация между 
компоненти в различни среди, те полагат новия стандарт за най- 


оптимални уеб приложения в интерактивна среда. 


Маубаг Зеагсп 


бщераг Мат 


Вицоп 


Сеп! Сотропеп! 


Зегуег Сотропеп! 


фиг. 110. Изображение, показващо примерно хибридно уеб приложение, 
което използва сървърни (зегмег - обозначени в синьо) и клиентски (Сеп - 


обозначени в лилаво) компоненти. 


14. Основни архитектури на приложно-програмен 


интерфейс (ППИ) 


Основните архитектури на приложно-програмния интерфейс (ППИ) 
определят начина, по който се разработва даден сървърен софтуер, 
неговата комуникация, мащабируемост, ефективност и 


производителност. В зависимост от > специфичните нужди > на 


ЛВ а 


приложението, архитектурите на ППИ могат да бъдат класифицирани в 
две основни категории: монолитна архитектура и архитектура на 
микроуслугите. Всяка от тези архитектури предлага различни 
предимства и недостатъци, като изборът между тях зависи от конкретния 
случай на употреба, изисквания за мащабируемост, гъвкавост, големина 


и брой на екипи, финансиране и поддръжка. 


+ 


момоитн 


фиг. 1.1. - Разлика между монолитна архитектура, изобразена с „Мопот!", и 
архитектура на микроуслугите, изобразена с „МопоШ!Н”, който представлява 


АР!-Сатеугау ”“, и “Зегисе", които представляват услугите 


141. Монолитна архитектура 


Монолитната архитектура за ППИ представлява сървърен софтуер, 
който е разработен като единно, неделимо цяло. Всички компоненти на 
приложението, като междинния софтуер, връзката с базата данни, 
контролерите и цялата бизнес логика, са тясно интегрирани и работят в 
рамките на един и същ процес / програма. 

Предимствата на монолитната архитектура включват лесната 
разработка в малки екипи, тестване и мащабиране в ранните етапи на 


разработката на приложението. Освен това, тя предоставя висока степен 


ТУ 


на интеграция, бърза комуникация и намалява комплексността, свързана 
с управлението на множество зависимости (дерепаепсез) и компоненти. 

Въпреки това, монолитната архитектура може да представлява 
предизвикателства при мащабиране или актуализиране на отделни 
компоненти на приложението. Тъй като всички компоненти са тясно 
свързани и интегрирани, промяната в един от тях може да наложи 


необходимостта от тестване на цялото приложение. 


1.4.2. Архитектура на микроуслугите 


Архитектурата на микроуслугите е подход за разработка на 
сървърен софтуер като набор от малки, независими „услуги“, всяка от 
които работи в свой собствен процес и комуникира с другите 
миркоуслуги чрез комуникационен протокол като НТТР или специално 
създаден такъв за такъв тип архитектура - аНРС. Всяка микроуслуга е 
фокусирана върху изпълнението на точно една конкретна бизнес 
функция (задача) и може да бъде разработвана, разширявана и 
мащабирана независимо от останалата част на системата. Което означава, 
че тя може да бъде оптимизирана дори и на друг програмен език, който 
е подходящ за дадената функционалност - пр. Ана Рубоп, а останалите 
функционалности (микроуслуги) на Зама 5рппа. 

Това позволява на екипите да разработват и актуализират услуги 
независимо един от друг, като по този начин се намалява времето за 
разработка на нови функции. Също така, архитектурата на микроуслугите 
улеснява мащабирането на отделни части на приложението в отговор на 
специфични натоварвания, което може да доведе до по-ефективно 
използване на ресурсите и подобряване на бързината на приложението. 

Въпреки тези предимства, архитектурата на микроуслугите 


представя предизвикателства, свързани с увеличената сложност на 


Виа 


управлението на множество „услуги“, необходимостта от разработване на 
надеждни механизми за комуникация между тях и гарантиране на 


сигурност и консистентност в една децентрализирана среда. 


АР! Сатемау БатБоо а91е 


а, АРРИСАТОМ 
ща 


а А АР! ъп : : 
САТЕМУАУ | Мкгозегисе 2 | 


фиг. 1.12. - Пример за архитектура на микроуслугите 


15. Технологии за разработване на уеб приложение 


151. АТМ! 


НурегТтех: Магкир Гапачаде - НТМГ, е стандартният маркиращ““" 
език, използван за създаване на съдържание в световната мрежа. То се 
структурира чрез използването на тагове за определяне на различни 
елементи като заглавия, параграфи, списъци, връзки, изображения и 
други мултимедийни обекти. 

НТМЕ е и стандарт, който се поддържа от МуЗС (Ууопа Уде Ууер 


Сопзотигп), като текущата версия на езика е НТМГ. 5.2. 


НТМЕ. 


фиг. 1.13. - Лого на НТМЕ 
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Шзедесс, 


Сазсайпа 5: е 5Пеейв - С55, е стандартният стилизиращ език за 
описание на външния вид и форматирането на документи, написани на 
НТМГ или ХМГ. Чрез използването на С55 може да се определят цветове, 
шрифтове, разстояния между елементите, структура на страницата, и 
много други аспекти на външния вид, без да е нужна промяна на 
структурата на НТМГ документа. С55 също се използва и за създаване на 


адаптивни уеб дизайни, спрямо размера на екрана на устройство като 


мобилни телефони, таблети, лаптопи, настолни компютри и телевизори. 


фиг. 1.14.- Лого на С55 
1:5.а, дамазскуее 


Замазспр: е динамичен език за програмиране от високо ниво, 
поддържащ обектно-ориентиран и функционален стил на програмиране. 
Замазспр! е динамичен програмен език, широко използван за създаване 
на интерактивни уеб приложения. Той позволява на разработчиците да 
внедряват сложни функции на уеб страници, като динамично 
модифициране на съдържанието, контролиране на > мултимедия, 
анимации, и събиране на информация от потребителите. Той е скриптов 
език, който не се изпълнява от уеб сървър, а от уеб браузъра на 
потребителя, освен ако не се използва за разработка на приложно- 


програмен интерфейс с помощта на програмки рамки като Мойе.)5. 


фиг. 1.15. - Лого на Тауазспръ 
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1.5.4. Туребспре“ 


Турезспрт е отворен език за програмиране, разработен от М!сговзой, 
който е поддържа всички функционалности на Уамабспрт! и ги надгражда. 
Той добавя статични типове, интерфейси и класове към Замабспрт!, което 
улеснява разработката на по-големи и сложни приложения, като 
предоставя по-лесен начин за откриване на грешки по време на 
компилация. Този език за програмиране също може да бъде използван за 
различни цели като разработването на потребителски интерфейс или за 
сървърна част. Както Замазспрт, така и Туребспр! е поддържан от редица 
програмни рамки като Веаст, Апашаг и Мие.)5 Той се компилира до чист 
Замазспр!, което го прави съвместим с всички интерпретатори на 


Замазспрт и уеб браузъри. 


т 


фиг. 1.16. - Лого на Турезбспр! 


15.55. ВБеас5»“ 


Веас 5 е отворена Замазспри / Турезспр: библиотека за създаване 
на потребителски интерфейси, особено за уеб приложения от тип с една 
страница. Главната цел на библиотеката е да бъде проста, бърза и 
мащабируема. Неас! позволява да се създават приложения, които могат 
да променят своята информация без да има нужда да се презареди 
страницата. Веаст се фокусира върху ефективността на обновяването на 


потребителския интерфейс в отговор на промените в данните, като 


„2 


използва функционален подход и преизползваема компонентна 


архитектура. 


фиг. 1.17. - Лого на Веас5 


1.5.6. Мие 5“! 


Мие.5 е прогресивна Замазспр! или Туребспр! софтуерна рамка за 
изграждане на потребителски интерфейси. Лесна за интеграция в 
проекти със съществуващи уеб приложения, тя се фокусира върху 
декларативното изобразяване и съставянето на компоненти, подобно на 
Неас 5. Мие.)5 е проектирана да бъде гъвкава и лесна за използване, като 
по този начин позволява на разработчиците бързо да създават 
интерактивни и динамични уеб интерфейси, които се генерират и 


изобразяват в клиентския браузър. 


ЧУ мев 


фиг. 1.18. - Лого на Уие.)5 
1.5.7. Мехрбе“» 


Чех! 5 е софтуерна рамка за Замабспр! или Турезспрт!, базирана на 
Неасщ5, която позволява лесно създаване на статични уебсайтове и 
динамични уеб приложения със сървърно, статично и клиентско 
генерирано съдържание. Тя предлага оптимизирани предварителни 


настройки за производителност, снимкова, 5ЕО и мобилна оптимизация, 
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като същевременно улеснява маршрутизацията, като за разлика от 
Веас5 има вграден маршрутизатор, оптимизацията на изображенията и 


интернационализацията. 


КЕХТ.. 


фиг. 1.19. - Лого на Мехи5 


1.6. Технологии за разработване на приложно-програмен 


интерфейс и бази данни 


161. Рублоп“ 


Ру(поп е мощен, от високо ниво програмен език, който се отличава 
със своята четимост и яснота в синтаксиса. Широко използван за 
разработване на уеб приложения, автоматизация, анализ на данни, 
изкуствен интелект и много други области, РуШоп поддържа множество 
програмни парадигми, включително обектно-ориентирано, процедурно 
и функционално програмиране. Благодарение на обширната си 
стандартна библиотека и активната общност, РуШоп предлага богат 
набор от инструменти и модули за бързо и ефективно разработване на 
различни проекти. Рубоп поддържа голямо разнообразие от библиотеки 
и рамки, разработени от трети страни, като МигоРу за научни изчисления, 


Цападо и Назк за уеб разработка и Тепзог! !оуу за машинно обучение. 


е, руШоп" 


фиг. 1.20. - Лого на Рубоп 
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1.6.2. Пападо“м 


ОЦападо е софтуерна рамка за разработка на сървърни уеб 
приложения и софтуер за РусПоп, която насърчава бързото разработване 
и чист, прагматичен дизайн. Предоставя интегрирана система за 
управление на бази данни, богат набор от библиотеки за обработка на 
уеб заявки, сесии, удостоверение и авторизация и много други, което я 
прави предпочитан избор за разработването на комплексни уеб 


приложения с езика Ру оп. 


Фапдо 


фиг. 1.21. - Лого на СП/апдо 


1.6.3. Ехргез525“! 


Ехргез525 е бърза, гъвка и минималистична софтуерна рамка за 
Мойе.)5, предназначена за улесняване на разработката на сървърни уеб 
приложения и приложно-програмни интерфейси. Тя осигурява 
минимална и гъвкава структура, която позволява на разработчиците 
лесно да обработват НТТР заявки и отговори. Една от характеристиките 
на Ехргезв.)5 е нейната система за маршрутизиране, която позволява да се 
обработват различни НТТР заявки, въз основа на ОН адреса. Тази 
софтуерна рамка поддържа т.нар. междинни функции, които имат достъп 
както до заявката, така и до отговора. Тези функции са често използвани 
при автентикацията или при обработката на грешки. Ехргезз е широко 
използвана заради своята простота и гъвкавост, позволявайки на 


разработчиците бързо да създават надеждни уеб приложения. 


-хогезз 


фиг. 1.22. - Лого на Ехргез575 


са. 


1.6.4. Мезщ5»“! 


МЧез 5 е софтуерна рамка, която надгражда Ехргезв, за създаване на 
ефикасни, мащабируеми Моде5 приложения от страна на сървъра. 
Поддържа напълно Турезспр!, като позволява използването на чист 
Замазспр!;, 4|„комбинира елементи на  обектно 9“ ориентираното 
програмиране, функционалното програмиране и функционално 
реактивното програмиране. 

Мез 05 е вдъхновена както от Апашаг, така и от 5рппа. Поддържа 
инжектиране на зависимости и модули, което улеснява организацията на 


кода и подобрява мащабируемостта и поддръжката на приложенията. 


3) пезе 


фиг. 1.23. - Лого на Мез5 


165. Музоре“ 


Му5ОГ е популярна система за управление на релационни бази 
данни (ВОВМ9), която използва 501 (5игистигей Оцегу |Гапачаде) за 
управление на данните. Тя е с отворен код, като предлага висока 
производителност, надеждност и гъвкавост, и се използва широко в уеб 
приложения за съхранение и манипулация на данни. МубО е 
предпочитан избор за много разработчици поради своята съвместимост 
с множество платформи и лесната интеграция с различни програмни 


езици и технологии. 


Му5ОГ. 


фиг. 1.24. - Лого на Му5ОГ 
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1.6.6. Розтаге5 Ос“: 


Розтаге5 ОГ е мощна, отворена система за управление на обектно- 
релационни бази данни (ВОВМ9), която поддържа както 50 
(структурирани заявки за език), така и 35ОМ (за нерелационни заявки). Тя 
е известна със своята напреднала функционалност, надеждност, 
гъвкавост и поддръжка на големи обеми от данни, което я прави 
подходяща за сложни приложения, изискващи висока производителност 
и мащабируемост. РозтагебО! използва ММСС (Мегвоп Сопсиггепсу 
Соп!го!, за да гарантира, че много потребители могат да имат достъп до 


едни и същи данни едновременно без конфликти). 


Розюгез ОГ 


фиг. 1.25. - Лого на Розогез ОГ 


1.7. Интегрирани среди за разработка на уеб приложение 


и приложно-програмен интерфейс 


171. <“«Мвиа! 5Еидо Сойе (М5 Соде)““ 


Миа! 5тийо Сойе (М5 Соде) е безплатна, лека и мощна интегрирана 
развойна среда (ОЕ) от Мсгозой, предназначена за разработка на 
софтуер. Тя може да се използва на всички популярни операционни 
системи - М/ипдЯомуув, пасО5 и СМОЛ пих. Поддържа множество програмни 
езици с вградена поддръжка за Замабспр!, Турезспр! и Мойе.5, както и 
разширения за други езици като Руфоп, С++, СЕ, Виз, Со, Зама, РНР и 
много други. М5 Соде се отличава с бързото си стартиране, интуитивен 


интерфейс, вграден С! контрол, и множество разширения, което го прави 
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предпочитан избор сред разработчиците за различни проекти. Средата 
осигурява и автоматично довършване на код и предложения, докато 
пишете, спрямо синтаксиса на езика. Редакторът има вграден терминал, 


чрез който могат да се изпълняват команди и скриптове директно от него. 


Мвуиа! 5шао Соде 


фиг. 1.26. - Лого на Мвиа! 5гийю Соде 
1:7.2. “8 Зе(Вга!пз Ууерзтоггп»г“! 


ЗетВгатз УМерзтотп е мощна интегрирана развойна среда за 
модерна Замабспр! и Туребспр! уеб разработка. Поддържа разработка 
както и на потребителски интерфейс, така и на приложно-програмни 
интерфейси с Мойе 5 (или негови софтуерни рамки). Предлага много 
добра поддръжка за Неас 5, Мех 5, Апашаг, Мие.)5 и други популярни 
софтуерни рамки за ЗУамабспре и Туребспр!. УМеббтотп осигурява 
интелигентно писане на код, автоматично довършване на синтаксис, 
бързо откриване на грешки или предупреждения и изключително лесен 
рефакторинг”““”" Тази развойна среда е предпочитана от много 
разработчици на уеб приложения и сървърен софтуер поради нейната 
ефективност, много вградени функционалности и удобство при 


създаването на сложни уеб приложения. 


фиг. 1.27. - Лого на И/ербгопт 
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173. Гедрос““ 

гед е високопроизводителен, мултиекранен редактор на код, 
създаден от създателите на Агопп и Тгее-зег. Той комбинира мощта на 
интегрираните развойни среди с производителността на лек текстови 
редактор. Фед е проектиран за производителност и ефективно 
използване на мултиядрени процесори. Тази ИСР излиза на пазара в 
края на 2022г., като през 2024г. кодът на платформата беше отворен и 
публикуван. С отварянето на кода на 2ед, проектът придоби огромна 
популярност. Фед е най-модерният редактор на код, който поддържа 
функции, като автоматично довършване на синтаксис, мулти-буфери, 
терминал, Мип режим и много други. За жалост 2едй е още в началният си 


етап на разработка, като поддържа само пласО5. 


фиг. 1.28. - Лого на Феа 
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Глава || 


Функционални изисквания. Избор на софтуерни 


средства. Проектиране на базата данни 


21. Функционални изисквания на дипломната работа 


е Да се разработи платформа с уеб приложение и сървърен софтуер 
с МехШ5 и ТаПмипЯС55 за потребителския интерфейс и Мез0Ш5 за 


приложно-програмния интерфейс 


е Да се разработи база данни с Роз аге5О! и времева база данни с 
Вед5 
е Платформата да разполага с удостоверение чрез имейл и парола 


чрез Разро 5 за Мез05 

е Платформата да разполага с авторизация и роли с различни нива на 
права, като модератор и администратор. Където модератор може да 
променя или изтрива съдържанието на обикновените потребители, а пък 
администратор да има достъп до защитени администраторски пътища и 
услуги 

е Потребителите да могат да публикуват обяви за продажба или 
отдаване под наем на снимачна и аудио техника 

е Потребителите да могат да препоръчват (създават) места за снимане 
и места за създаване на съдържание с интерактивна карта на Соод!е Марз 
е Потребителите да могат да качват ревюта, оценки или коментари на 
обяви, места и други потребители 


е Платформата да разполага с търсачка на обяви, места и потребители 
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2.2. Избор на софтуерна среда и технологии 
221. <4ЦЗе(Вга!п5 Ууербгогга 


Интегрираната развойна среда за разработка на софтуер, избрана 
за изпълнението на тази дипломна работа е, УМеббтогп, създадена от 
ЗетВгатз. Нейният избор мотивиран от много добрата поддръжка за 
Замабспр! и Туребспр!, както и за техни софтуерни рамки като Неас бо, 
Апашаг, Мие., Мойе., Ехргез5 и Мез 05. 

Умерзгопт разполага интегрирано откриване на грешки и 
предупреждение, благодарение на интеграция с Еб0п?. Други 
функционалности на средата са: интелигентно автоматично довършаване 
на код (спрямо синтаксис), навигация и рефакторинг, което значително 
ускорява процеса на разработка. 

Тази среда за разработка е предпочитана заради своята 
ефективност, удобен интерфейс, много разширения от трети страни и 
обширни инструменти за разработка, които помагат за повишаване на 
продуктивността и качеството на кода. Както и дълбока интеграция с 
други продукти на Зе Вгаз като ОатаСпр за връзка и визуализиране на 


бази данни. 


фиг. 2.1. - Отворен проект в И/ебзтогтт с отворени множество прозорци за 


файлова структура, таблици в база данни, терминал и файл. 
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222. „Ме55 


Мез05 е избрана за тази дипломна работа за разработка на 
приложно-програмния интерфейс, поради своите богати и съвременни 
функционалности и предимства за разработка на сложни, мащабируеми 
и лесно поддържани сървърни приложения. Като софтуерна рамка, която 
е базирана на Мойе.з / Ехргез5 и използва предимно Туребспр!, Мезщ5 
предлага ефективна структура за организиране на кода чрез модули, 
резолвъри и контролери, което улеснява разделението на логиката и 
повторната употреба на кода. 

Мез5 също поддържа ОПерепдепсу ц|еспоп”?“, по подобие на Зама 
5рппа който улеснява управлението на зависимостите, а системата за 


модули спомага с ясната организация на приложението. 


А (525 
С пн..| С 


А Б 


4 


() 
| А Деретйепсо) 


фиг. 2.2. - Пример за Оерепаепсу 1 пресиоп 


В Мез 05 за отделните функционалности се създават модули. Всеки 
модул е изграден от три неща: контролер, зегмсе (или още познат като 
резолвър, в който се намира бизнес логиката) и ОТО (Пата Ассезз ОЩес!), 


които Са модели за пренос на данни между различни процеси и 


а 


функционалности на даден софтуер. Най-често се използват за 


информацията, която се предава и получава от външния свят. 


АррИсацоп Моше 


Изегв Модше Огдегв Мойше Спа! Моше 


Ееаиге Модше 1 Ееашге Моше 2 Ееашге Модше 3 


фиг. 2.2. - Модели и тяхното разпределение по функционалности 


Мез05 разполага и с допълнителни функционалности, които 
изключително много надграждат Ехргезв - филтри, ррез, интерсептори и 
дчагдв. 

Филтрите позволяват обработка на грешки (ехсерПопз) за постигане 
на консистентност в отговорите на грешки, които се връщат на клиенти, 


както и за осигуряване за постоянно изпълнение на приложението. 


Рре 


Рре 
Рре 


4 » абец) 
Спет 5ще Воше Напйег 


фиг. 2.2. - Филтри 


Ррез са класове, които са анотирани” 2“ с декоратора (О/п/естаБ!е)), 
който имплементира интерфейса РгретгапзЮюгт. Често, те имат два 
типични случая на използване: 

- За трансформация - преобразуване на входните данни в желаната 


форма (примерно от стринг към целочислено число) 
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За валидиране - сравняват се входните дали са от даден тип, или дали 
отговарят на дадени изисквания. Ако те са валидни, ще останат 


непроменени, ако не са, ще се върне грешка на клиента. 


Сем 5ще 4 асец) 


Коше Напфег 


ЕШег 


ЕШег 


фиг. 2.3. - Ррез 


Интерсепторите също се анотират с декоратора (а/п/есгабее). Те 


предоставят механизъм за манипулиране на логиката на заявките и 


отговорите, улеснявайки трансформацията на данни и управлението на 


операции като кеширане. Те са вдъхновени от концепцията за аспектно 


ориентирано програмиране, къде те дават възможност за: 


Добавяне на логика преди и след изпълнението на дадена функция 
Трансформиране на резултат, вследствие изпълнението на дадена 
функция 

Трансформиране на грешки вследствие изпълнението на дадена 
функция 

Допълване и разширяване на логиката на дадена функция 

Или цялостна промяна на логиката на функцията (омегпае), спрямо 
данните, които са й подадени. Това най-често се използва за 


кеширане. 


абец) 


4 Кошще Напйег 


имегсертог ) 


фиг. 2.4. - Интерсептори 


Сем 5ще 
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ОцагяЯв също се анотират с (О/пуесгаре(). Те имат само една цел и тя 
е да осигуряват сигурност, като позволяват лесно управление на 


разрешенията, правата до достъп и авторизация. 


Спем 94е 3 Коше Напфег 
аКедиезйМарртпа 


Фиг. 2.5. - Сиагав 


Мез 5 предлага и вградена поддръжка за създаване на приложно- 
програмни интерфейси с архитектура на микроуслугите, което позволява 


лесно създаване на сложни и децентрализирани системи. 


223. Рпизгла ОВМС“! 


ОвМи" (ОЩест-Вейапопа! Маррта) е техника за преобразуване на 
данни между несъвместими системи в обектно-ориентираното и 
функционалното програмиране, което позволява на разработчиците да 
работят с бази данни чрез високо ниво на абстракция - модели, които са 
типизирани обекти. 

Рпзгла е модерен ОНМ, който предоставя чудесно изживяване в 
процеса на разработка (ОХ) като го прави един от най-предпочитаните 
ОЕМ софтуери при използване Моде.5. Той улеснява работата с бази 
данни в приложения, разработени с Мойе 5 и неговите софтуерни рамки 
като Мех!иб5, Мез 5 и други. Рпзгла също работи и с много голям набор от 
най-популярните софтуери за бази данни като МубОГ, РгозтагебоГ, 
МапаОв, СоскгоаснОВ, Мопаойв, 50 Те и много други. Той предоставя 
типизиран, чист и безопасен интерфейс за достъп до базата данни с 


Туребспрт. 


са. 


Рпзгла ОВМ улеснява процеса на моделиране на бази данни, като 
разработчика трябва да създаде само една схема: „зсПегпа.рпзгпа", в която 


трябва да опише таблиците, полетата, техните типове и връзки (фиг. 2.1.). 


| Рита зспета е Пагавазе 


Увег 


По 14: МТЕСЕК 
ета!: 50 пе ета!: ТЕХТ 
пате: 51 пе пате: ТЕХТ 
ро5!5: Ро5Ц| КЕГАТОМ 


Роз! 


. 14: МТЕСЕК 

еди аЧе: ТЕХТ 

е; 5ейпв роз! соп!еп!: ТЕХТ 
сопхепе: УМпЕ ривней: ВООГЕАМ 
ризрацед вошели ашнопа: МТЕСЕВ ЕК 
аш ог: Изег ВЕГАПОМ 

ацшглопа: пп ЗСАГАВ 


фиг. 2.6. - Ризта модел към база данни 


Като след създаване или промяна на тази схема, преди промените 
да влезнат в ефект, Рпзга предоставя изключително опростен 
интерфейс за създаване на миграции. Това улеснява изключително много 
създаването на структури на бази данни, тяхното следене и създаване на 
миграции и други промени. Поради това тя беше избрана за ОНМ на 


сървърния софтуер на тази дипломна работа. 


Ризта 


фиг. 2.7. - Лого на Ризта 
224. Ргозтагез5оГ 


Базата данни, която се използва в тази дипломна работа, е 
Розтогеб5 ОГ, поради нейната скорост и оптимизации за съхраняване на 


множество данни. Тя лесна за използване и има много добре описана и 
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подробна документация. Има голямата общност, която използва 
Розтогеб ОГ, която непрекъснато създава допълнителни функции както за 
самата база данни, така и за инструменти като ОВМ, с които да се 
подобрява функционалността и изживяването на разработчика (ОХ). 
Освен това Розтаге5 ОГ, заедно с МубОГ, са с най-голяма поддръжка в 
Рпзгла ОВМ и разполагат с много повече функционалности, включително 
РП Тех беагсп“. Лично разполагам и с много предишен опит в 


разработката на бази данни с Розтоге5 ОГ. 


225. Веасъб5 


Неаст е Замабспр! библиотека, създадена и поддържана от Мета, 
която се използва за изграждане на потребителски интерфейси. Тя се 
използва в много от приложенията на Мета като Чпзгадгагп Рог Ууер", "Мета 
Ассоип! Мападегпеп!" и БасеБоок. Веас: може да се използва както за 
създаване на мобилни (чрез Неаст Майме), така и на приложения с една 
страница. 

Неас позволява разделянето и преизползването на код чрез 
компоненти, които се генерират и визуализират (гепдеп в ООМ“" на уеб 
страницата. Компонентите могат да приемат параметри, наречени "ргорз" 
- свойства, и да бъдат декларирани като функции, връщащи 295Х. Веас! 
използва виртуален ПОМ за оптимизиране на актуализациите в реалния 
ОГОМ, визуализирайки (гепдег) само променените части, което увеличава 
ефективността на приложението, като използва сравнително по-малко 
ресурси. 

35Х е разширение на ОЗауабспрЕ синтаксиса, което улеснява 
структурирането на интерфейси в Неаст чрез НТМГ-подобен код. 95Х 
поддържа НТМГ атрибути и позволява добавянето на персонализирани 


атрибути, които компонентите получават като свойства (ргорз), 
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улеснявайки динамичното въвеждане на данни и поведение в уеб 


приложения. 


Мисиа сом Кеа! ПОМ 


фиг. 2.8. - Как Веас! 75 използва виртуалния ООМ, за да модифицира само 


променените части 


2.2.6. МехШб5 


За изграждането на потребителската част на дипломния проект е 
избрана софтуерната рамка на Веас 05 за изграждане на цялостни уеб 
приложения - Мех б, заедно с Туребспрт!, като език на разработка. 

Мех!шб5 е разработена от Мегсе!, тя използва Веаси5 компоненти за 
изграждане на потребителския интерфейс. Мехшб5 абстрахира и 
автоматично конфигурира инструментите, необходими за Неас!, като 
пакетиране, компилиране и др. Главните функционалности на МехШб, с 
които надгражда Неасоб, са: 

- Вградена маршрутизация - МехШб5, за разлика от Неас 5, където 
трябва да се използва външна библиотека (като Неаст Ношег) за 
маршрутизация на пътищата, използва файлово-базирана 


маршрутизация. 


С Бюд : С) дазпбоагй  воо: 


2 вша! | 


: О) апауйсв СО) вейтдв 
т 


Геа? | 


Н 
Н 
С) раззмога 3 рготе ! 
! 


фиг. 2.9. - Структура на екрани и маршрутизация в Мех 5 
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Смесено генериране и изобразяване (гепдеппа) на страници и 
компоненти - МехшШ5 по подразбиране използва сървърни Неаст 
компоненти и използва клиентски или при експлицитно поставяне на 
„Чзе сПпепг” в началото на документа, или при дете на такъв файл. 
Благодарение на това МехШб5 се използва за създаването на модерни 
хибридни уеб приложения, които разполагат както със сървърни и 
клиентски компоненти, така и със страници, които могат да бъдат 
изцяло статични, статично или динамично сървърно генерирани и 
клиентско генерирани. Всичкото това позволява на Мех 5 да бъде 
най-оптималната софтуерна рамка за разработване на потребителски 


интерфейс с Замабспри / Турезспри. 


ит: 


Сем бегуе! 


фиг. 2.10. - Клиентско и сървърно генериране и изобразяване (гепаеппа) 


Оптимизация за извличането на данни (етситпа) - Мех 5 надгражда 
стандартната Тетсп функция в Замабспрт, чрез нейни оптимизации за 
клиентско и сървърно извличане на данни, като вградено кеширане, 
меморизация“" и ревалидация“". Освен това при сървърните 


компоненти има поддръжка за асинхронно извличане на данни чрез 
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азупс / амкай на Замабспрт, както и поддръжка за паралелно сървърно 


извличане на данни. 


КооПауощ (СЕ зДеиа вт (”) 
ОазнБоагаауош! (СЗ С) е 
Зет пазРаде саита) (2) ; (иииио) е) 


фиг. 2.1. - Разликата между последователно и паралелно извличане на данни 


на сървъра в Мех!/5 13+ /арр 


Мех! 5 също разполага и с вградена поддръжка за стилизация чрез 


С55 модули, Та!м/пЯС55, 5аз5 или С55 в Замазспрт. 


МехШ5 разполага с изключително много  оптимизации за 
мултимедийни формати, шрифтове, зареждането и изпълнението на 
външни скриптове, както и с много интеграции в платформата на 


създателя на Мех! - Мегсе!|. 


Мех 5 взима концепцията на Неас! за преизползване на компоненти 
ия вдига на друго ниво с |ауочт)5 и Тегпр!ате.)5 - специални файлови 
типове, които се използват за обвивки (консистентни Цауочтз) или не 
(геглрате.)5)) около дадени пътища. Те най-често се използват в 
смисъла на навигация или повтарящ се обвиващ код, или за 
поставяне на контекст“ който да обгражда всички компоненти под 


него (показани на фиг. 2.12. на следващата страница). 
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5) (0 
арр 
Гауоч?.)5 
дазпроага 


Гауоч!.)5 


зейтаз (СО) (епамучез) (Г) 


апауйсз 


фиг. 2.12. - Структура и шаблонни обвивки в Мехъ75 


Мехш5 разполага с още много специални файлове като |оадйпод.5 
(компонент или страница, която се визуализира, докато се извършва 
извличане на данни), еггог.5 (клиентски компонент-страница, който 
обвива всички пътища над него, извиква се и се показва на 
потребителя при грешка, която е настъпила на същото или по-ниско 
ниво на маршрутизиране в дървото на файловата система, по!- 
Гоипа.|5, който работи по подобен начин на еггог.), но за грешка 404 
за ненамерен ресурс. Има и още много други специални файлове, 


които може да бъдат разгледани в документацията на Мех 5. 


Една изключително важна функционалност е, че за всяка страница 
може да се експортират т.нар. метаданни за страница, които могат да 
бъдат статични (непроменящи се) или динамични (съдържащи 
информация от база данни - примерно за страница на даден продукт. 
Тази функционалност изключително помага както на търсачките за 
оптимизация 5ЕО, така и за потребителското изживяване, като се 


споделят различни линкове (страници) в приложения, които 


ЗРАа Е 


поддържат автоматичен преглед и визуализиране на кратки данни 


(метаданни) за дадена страница. 
2.27. Мехрсинии“ 


Мех-п!! е библиотека за Чех б, създадена отново от Мегсе!, за ПВп 
(интернационализация) на уеб приложенията. Тя е изключително 
опростена библиотека, която работи както и за по-нови версии на Мехишб5 
(с /арр), така и за по-стари (с /радез). Включва и функции за локализация 
на съобщения, ППИ, базиран на ПооКз (или сървърни азупс функции за 
азупс сървърни страници) за преводи и форматиране, и инструменти за 
форматиране на дати, време и числа. Мехии! е проектирана за 
производителност и е създадена специално за Мех 5, по подобие на 
геасъ- пп, поддържайки международни пътища. Поради това и факта, че 


Мегсе! поддържа библиотеката, тя е използвана в тази дипломна работа. 


СР пехъпн 


фиг. 2.13. - Лого на пех-ти 
22.88. (Омс.д/геаст-доод1е-гар 


Омв.д/”геаст-доод1е-тар“М е най-модерната, бързата и поддържана 
нова Замабспр: библиотека за Соод1е Марз за използване с Неасшб5 и 
Турезспр!. Публикувана за първи път на 05.1.2023г. и промотирана от 
официалните канали на Сооде СоцЯ в техния уебсайт, пргп.согп и 
популярната платформа за видеосподеляне - УоцТие, тя набързо добива 


популярност ред Веаси5 общността. Разработката на м!5.а също сменя 


ТА 


първоначално използваната библиотека в тази дипломна работа - 


доод1е-гпар-геасъ““! 


ЧУ пеастдооще-тарво Ехатрев Посв 


геас!-доос/е-тарз такез изто "пе Соос!е Марз 
Замабспр! АРИп Веас! аррисайопв еазу. 


45» Веасътеоганоп 
Цвва Своде Мар + 


3 Ежепе! 
Соте 


фиг. 2.14. - Уебсайт на библиотеката (ду.дИгеас!-доод1е-тар 


229. БуЦВУ! 


ЗУУВ е библиотека, създадена от Мегсе!, отново, която е създадена и 
оптимизирана за извличане, кеширане и ревалидиране на данни в 
клиентски компоненти на Неас 5 и МехШб. Името "5УУН" произлиза от 
згае-у!е-геуапаате - стратегия за  инвалидиране на НТТР кеша, 
популяризирана от НТТР НЕС 5861. ЗУУН е стратегия, при която първо се 
връщат данни от кеша, когато е възможно. След това се изпращат заявки 
на определен интервал от време (процес на ревалидиране), за да 
информацията да бъде актуална. Това е най-популярната библиотека за 


извличане на данни за клиентски компоненти и е препоръчвана от Мегсе! 


гала 


ЗуВ 


Веас! Ноокв Рог Оата ес па 


фиг. 2.15. - Лого на 5УМР 


като стандарт. 


а 


2.20. Ахоюзк 


Ахоз е НТТР клиент, базиран на Замабспр! Ргоповез, за Моде)5 и 
браузъра. Използва се извършване на НТТР заявки. Тя предлага лесен за 
използване ППИ, като улеснява изпращането на асинхронни заявки, като 
поддържа използването на интерсептори за заявки и отговори, 
преобразуване на заявки и отговори, и автоматично преобразуване на 
35ОМ данни. Библиотеката Ах!оз е избрана заради нейната надеждност и 
гъвкавост при работа с мрежови заявки. Заедно с 5УУН на Мегсе!, те правят 
една чудесна комбинация за извличане на данни от клиентските 


компоненти в уеб приложението. 


ДУ (е: 


фиг. 2.16. - Лого на Ах!о5 
221. 25ОМ! 


35ОМ Памабспр: ОЖес! МотаПоп) е текстово базиран стандарт за 
обмен на данни, който е лесен за четене и писане, анализиране и 
генериране. Форматът на 25ОМ е с лесен синтаксис за представяне на 
структури от данни и обекти, състоящи се от двойки ключ-стойност. 
Използва широко в уеб разработката за сериализация и предаване на 
структурирани данни през мрежата, особено между сървъри и уеб 


приложения. 


)50М бушах 


Ше оппие 


: , 
л. Иепоппи, ) 


фиг. 2.17. - Примерен 715ОМ файл 


Ера Е 


2.212. 709й- 


709 е библиотека за валидация на данни в Туребспр?!, която 
улеснява строгото типизиране и валидиране на структури на данни. С 
709, разработчиците могат лесно да дефинират схеми за валидация, 
които автоматично генерират ТурезспрЕ типове, подобрявайки 
безопасността на типовете и намалявайки вероятността за грешки при 
работа с данни. 209 се използва в клиентския софтуер за валидиране на 
данните от потребителския вход преди да бъдат изпратени и валидирани 


от сървъра. 


Ф пи я 709 Зспета 


Вип-Чте (МайдаЧоп) згайс Спеск (Турез) 


фиг. 2.18. - Как работи Хоа 


2.213.2ММТ" 


ЗУУМТ 05ОМ Мер ТоКкеп) е отворен стандарт (ВЕС 7519), който 
дефинира компактен начин за сигурно предаване на информация между 
страни като 25ОМ обект. Информацията може да бъде верифицирана и 
доверена, тъй като е подписана. Те са широко използвани за 
удостоверяване и обмен на информация в уеб приложения като токени. 
Веднъж създаден и върнат на клиента, той може да го използва, за да 


докаже своята самоличност пред сървъра. Тези токени са подписани от 


Вр раит 


ключ, намиращ се на сървъра, така че да може да удостовери подписа за 


валиден. 
5;гистиге оГа )5ОМ Ме ТоКеп (МИТ) 
5ирегТаКепз 
фиг. 2.19. - Какво се съдържа в примерен ЛМУТ 
2214. Бефв" 


Нед е база данни с отворен код, която се съхранява в оперативната 
памет, което я прави изключително бърза. Тя се използва за много 
различни случаи като кеширане на заявки от друга база данни (или ППИ), 
за стриймване, за съхранение на документи, като брокер на документи 
или като векторна база данни. Тя поддържа структури от данни като 
стрингове, хешове, списъци (листове), обекти, сортирани обекти и 


поддръжка на сложни заявки. 


638 с45 


фиг. 2.20. - Лого на геа!6 


Недв се използва в тази дипломна работа за съхранение на 
невалидните (забранени) НейезПп УЗМУТ токени, които ще бъдат по- 
подробно обяснени в трета глава. Една от причините за нейното 
използване е, че е изключително бърза и няма по никакъв начин да 


забави процесите за удостоверение и авторизация на приложно 


БД 


програмния интерфейс. Но главната причина е, че Нед!в разполага с една 
много важна функционалност и тя е ТП - Пгле То Пме, т.нар. време на 
живот на даден запис, който с всяка секунда се намалява и при достигане 
на О - той се изтрива автоматично. Това е изключително полезна 
функционалност, тъй като забранените токени изтичат и не бихме искали 
да съхраняваме изтекли такива, тъй като не само ще заемат място, но и ще 


забавят и процеса за намиране на такъв запис. 


Тетр Аде :24 „1 ) 


Етроуее хмаде: 40 


Кеу Оеетеа 


фиг. 2.21. - Примерна функционалност на ТП! запис в геа!5 


22.15. Агпагоп АУу5 53“ 


Аглагоп Ауу5 53 (З1гпр!е 5Тогаде 5егисе) е облачна услуга, предлагана 
от Аглагоп, която позволява да се съхраняват и извличат файлове (обекти) 
по начин, който е силно мащабируем и издръжлив. Те могат да бъдат 
бързо извличани всяка точка на света, благодарение на широкото 


разпространение на АУуМ5 сървърите. 


Атагоп 53 


фиг. 2.22. - Лого на Атагоп 53 


Тази услуга може да бъде използвана за различни нужди, като 
съхранение на статично мултимедийно уеб съдържание - снимки, 


смалени снимки (Шигрпа! - миниатюра), видеа, анимации, иконки и 


Фази 


други. Всички обекти се съхраняват в т.нар. кофи, които са логически 
контейнери за обектите. Всеки съхраняван обект има уникален ключ 


(неговия път от корена), който се използва за извличането на обекта. 


Ощес 105 


ОВЗЕСТ 


овзеСТ 0 МЕТАОАТА овзЕСТ С овает С овавст. 


овзЕСТ овзЕСТ овзЕст 


На АйдЯгезз 5расе 


фиг. 2.23. - Каки какво се съдържа в обектното хранилище и обектите 


В тази дипломна работа Агпагоп 535 се използва заедно с Аглагоп 
СоцЯЕгопЕ, който представлява СОМ“ за кеширане и равномерно 


разпределение на данните в различни сървъри по света. 


2.2.16. Соод1е Марз Ра“ оггаМ 


Сооде Марз РаЧоггт предоставя инструменти за множество 
различни операции с карти. Тази платформа е най-добрата на пазара, 
поради огромния размер на данни, които Соод!е съхранява и предоставя 
на своите потребители и разработчици. Функционалности, които се 
използват в тази дипломна работа са обратното геокодиране и 
визуализацията на карти, които са интегрирани в най-основните 
функционалности на уеб приложението - от създаването на места или 
обяви, в които се избира адрес от интерактивна Соод/е карта, до 


визуализирането на всички места на една обща Соод!е карта. Обратното 


В луда 


геокодиране се използва за превръщане на координатите на обяви и 


места в четими адреси на език, избран от потребителя. 


фиг. 2.24. - Лого на Соодпе Марз Райотт 


2.21. ТаймуипаСдб"! 


Тайм пяЯС55 е С55 софтуерна рамка, която позволява стилизирането 
на уебсайтове и уеб приложения директно в НТМГ документите чрез 
класове. Този подход улеснява бързата разработка на собствени дизайни 
без да е необходимо да се пишат стилове, класове и С55 файлове от 
нулата, като същевременно се поддържа консистентност и се избягва 
излишният С55 код. Та!мипЯС55 е предпочитана софтуерна рамка заради 
своята гъвкавост, ефективност и лесна употреба в модерната уеб 
разработка. Тя е избрана не само заради тези изброени причини, но и 
благодарение на дългия ми опит с разработка на различни уеб 


приложения с ТаймипЯС55, включително и уебсайта на ТИЕ5 Ее! 2025. 


<>- цчаймпдсвв 


фиг. 2.25. - Лого на ТаймитаС55 


22.18. Та е сопз“" 


Една от най-важните части на едно приложение, независимо дали е 


уеб или мобилно, е да разполага с консистентен дизайн, което означава, 


СА: 


че трябва да се използват и иконки от една и съща библиотека или 
колекция. Една от най-богатите такива е ТаЖег |сопз - огромна колекция 
от безплатни, висококачествени 5МО иконки, оптимизирани за уеб 
дизайн и приложения. Те са проектирани да бъдат прости, изразителни, 
и най-важното - красиви. Тази колекция е идеална както за разработчици, 
така и за дизайнери, поради нейната интеграция както в Неас? (и други 


софтуерни рамки за 395), така и във Нагла (под формата на разширение). 


ооо ппофофоеофов 
ое 5 » ве с 
още 
ча 
„+ С ТаМег и 
|(СОМм5 е 
вв # хо 06 
во оетешпооосовви 


фиг. 2.26. - Лого на ТаБ!ег !сопз 


2.29. Ргешеп!“ 


Ргешег е инструмент за форматиране на код, който автоматично 
организира Замазспрт, Туребспрт, С55 и други поддържани езици, за да 
направи кода по-четим, консистентен и подреден. Той се интегрира с 
много редактори и разводни среди за разработка на софтуер, като Мвиа! 
5ТияЯо Содйе и всички развойни среди на ЗетВгатз. Рге ег разполага и с 
много допълнителни разширения, създадени от трети страни, които 
спомагат още повече за структурирането на кода. Една от тях е Рге Шег Гог 
Та!мипЯС55, която сортира и форматира класовете, които съдържат 


Та!мипЯС55 класове, правейки ги много по четими. 


РгеТтТтег 


фиг. 2.27. - Лого на Ргейег 


За 


2220 Е ри 


Е5ПпЕ е инструмент за статичен анализ на код, който помага на 
разработчиците да откриват и коригират проблеми (грешки и 
предупреждения) в Зауабспрт / Турезспр! кода на даден, като следват 
предварително дефинирани правила за стил и качество на кода - които 
са дефинирани както глобално, така и в локален файл. ЕЗ5Шп! разполага с 
много високо ниво на конфигурация и даже поддържа добавянето на 
разширения или унаследяването от други проекти или компании - 


примерно Е5Пп! конфигурацията на АиБп. 


(С) ЕФППЕ 


фиг. 2.28. - Лого на ЕЗипЕ 
22.21, Розугпап“ 


Роз пплап е най-популярният инструмент за разработване и тестване 
на приложно-програмни интерфейси. Той улеснява изпращането на 
заявки към ППИ, визуализацията на отговорите, автоматизацията на 
тестове и създаването на документация. Също така, Роз гпап предлага 
функции за работа в екип, което позволява на разработчиците да 
споделят и управляват заедно тестове и документация с други членове 


на екипа за тестване и разработване. 


Ноте  Могкврасев > АР! Мецмогк с + имцо 


2, мумоткврасе 


мар/Посатозе:80вО/расе/2. 
Содеснопв 


пирв:Лепзепд-арикаюуаплест/арурасе/?. 


Е расе 


мари Посатов:8080/риас. 


фиг. 2.29. - Примерна заявка в Розитап 
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2.2.22. Ната”" 


Нагпа е най-популярният и прост инструмент за създаване дизайн 
прототипи, който позволява на дизайнери и екипи да създават, 
сътрудничат и споделят интерфейси и прототипи в реално време. Той се 
отличава с интуитивен интерфейс, функции за сътрудничество и 
вградена поддръжка за дизайн системи, което го прави идеален за 
създаване на дизайн за уеб и мобилни приложения. 

Нагпа е използвана в този дипломен проект за създаване на ранен 
дизайн и прототип на интерфейса на уеб > приложението 
(пегру/ппуший-.согл епяепа-Пагпа). Създаването на дизайн в началото на 
процеса на разработка на каквото и да е приложение, улеснява 
следващите етапи на разработка и предоставя консистентност в 


различните компоненти и страници. 


фиг. 2.30. - Екран за разработка във Рата на този дипломен проект 


22.23. ри" 


СИ е стандартът за система за контрол на версиите““, която 


позволява на разработчиците да следят и управляват промените във 


пр 


файловете на своите проекти. Тя поддържа ефективно сътрудничество 
между екипите, като предоставя инструменти за сливане на промени 
(глегае), автоматично или ръчно оправяне на конфликти (гезо!ме соп с!) 
връщане към предишни състояния и версии на кода, както и разделение 
на кода по бранчове за всяка отделна функционалност или логически 
разделена част от даден проект. С! е една от задължителни системи за 
използване по време на създаване на дипломна работа, поради нейния 
голям брой функционалности като следене на промените по кода и 
особено връщане на промени назад. 
1 
е! 
фиг. 2.31. - Лого на СП 


В разработката на този дипломен проект функционалността за 
разделение на код - бранчове, е използвана много често в за разделение 
на различните функционалности на приложно-програмния интерфейс и 


клиентски софтуер. 


ВКАМСН 


МАМ 


ТАВ Ргой 


фиг. 2.32. - Структура на СП хранилище с бранчове 


РРДР СЕНИУБ”» 


СЕНЧБ е уеб-базирана платформа за хостинг на проекти и извадки 
код, която използва Ой за контрол на версиите. Тя позволява 


съхраняване, споделяне и сътрудничество по проекти и хранилища. 
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СИНиР предлага функции като преглед на кода (сойе гемеуу), управление 
на проекти (ргофест глападегпепЦ), създаването на „проблеми“ (155пез5), 
които се използват за заявки за нови функционалности, оправяне на 


бъгове, документация ит.н. 


С! Ни 


фиг. 2.33. - Лого на СЕНчи 


СЕНИВБ позволява и интеграция и автоматизация на проекти чрез 
СЕНИБ АсПоп, които се използват в тази дипломна работа за проверка на 
изтекли лични данни (зесгет) и качване и публикува (дер!оу) на проекта в 
облака. В този дипломен проект са използвани 2 СЕНиБ хранилища - за 
сървърен и клиентски софтуер, които са интегрирани в един проект, в 
който са описани всички изисквания и задачи (като 1551ез), които трябва 
да бъдат свършени. За всяка функционалност се създава нов бранч (за 
даден проблем - 155пе), като при нейното финализиране се слива (глегае) 
в главния (дем) бранч за разработка чрез ай глегде и отварянето на ри! 


гедчезт. 


(О аириь.сопуКокозтес/: 


< о КокозТесп / |епз!епй-поптепа 


Соде (0) 5зиез 4 1 РшШгедиеяв (5) Асо А Ргфесв 1 СО ме 2 зесит 


Сфепяепа-нотепд Рок 


Р там - Р 24 Вгапсйез 


Сф кокозтесп тегае( 
Ва сити 

Ва рийс 

ш <с 

П) еапогсопйд 


П епиетрае ва(#1): пнайге п 2 то 90 Вееазез 


Раскадез 


З) ргещепапоге. 


фиг. 2.34. - СПНив хранилище на клиентския софтуер (потребителски 
интерфейс) на тази дипломна работа - !епз!епа 
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ЕО | 4 Регвопа! | < (О аппив сопуКоковтестепзепа-васкепа 8 


пе О КокозТес! / |епз!епй-Баскепа 


Сойе  (О) взиев 1) РиШгедиезв (9) Асо А Ргоесв 1 ПП уж  (О весшу | медмв #2 дешпдз 


Ф Гепяйепа-раскепй Роз 5) Ипрт 2 упиасн 1 + 


Р тат - Р 13 Вгапспев ( Тадв (с + + | Соце + 


Сф коковтесп 1. сагевогу 14 -> иша 6995109 - 3 даув аво <О 114 СоттИв 


в спи 


Ро О юПКв 
1) езйпйапоге. Вееазев 


1 езиигс 


ГП ачапоге 


Е Раскадез 
ГА ргещепапога 9 


Мо расадев риБйзнед! 
| ргешепс 


фиг. 2.35. - СПНир хранилище на сървърния софтуер (приложно-програмен 


интерфейс) на тази дипломна работа - !епз!епа 


2.2.25. Миакат пе?“ 


Умака пе е инструмент, използван от програмисти и разработчици, 
за автоматично проследяване на времето и за мониторинг на тяхната 
продуктивност и ефективност по време на програмиране и работа на 
проекти. Тази платформа предоставя подробна статистика за времето, 
прекарано в различни редактори и проекти, докато се използва 
клавиатура. Ууака пе автоматично отчита времето, прекарано в писане 


на код, без нуждата от ръчно стартиране или спиране на таймер. 


Ргоесво 


Гепяепд-опепа Гепяепд-раскепа 


61 г 8 пипз 


фиг. 2.36. - Време прекарано в писане на проекти, визуализирано и 


проследено с Иака!те 


Информацията се анализира и представя в удобни за разбиране 


графики и отчети, които могат да бъдат използвани за оценка на 


па 


продуктивността, планиране на проекти и подобряване на управлението 


на времето. 


227 нгз 55 тиз от ЕП ес 1512025 ипШ Уезбегдау. с 


9 7536 ти Моп Еев 1212024 0 


ОрегаНпд буз4етв 


фиг. 2.37. - Графично визуализиране на данни за определен период от време: 


0112.2023г. - 12.02.2024г. 
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2.5. Структура на базата данни 
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м Е --24 
и пи с ЗВвомнийлид ;: В: Сао СЕ СИ 8 ) лежа 
вдоиме реесвоп 
вдоиве ргесвюп 
расейивни (ЕС поша тех 
(Ибтигм, мландсцна! 
- зегсейша ина, -- | 
г --- + г , 
. | (АА 92 -“ 
Расетаде - ОвупаСоти " вчпд.иидсд Цзйпатаде 
ГО Расейероп Уоч хеж | хеж 
| м Па иа 8 ИзегбауедРасез #8 Изегвауейвипаз 1. сопщепи ма е 
+. геазоп два: ; | и " 1 стеацед,аг Птпезтатр(3) 
Е. огдог пиедег стоаой. ай Ислезцатри3) стемой, а Цтезтатр(3) и "акация 
сгеадед а чтозхатри3) е 4 " , г 8 ирдайей, а Цтевтатр3) , | 
и вайив "вдагия” дейехей, а Нтезпатри3) дейетей а: Штезлатри3) | стеапей а Утезцатр(З) 
В атейатра + сгеалей ат итезгатр(3) # С изег.иша тех + узег.иша хехе О земаом бпенатраа) + ордагей аг утезтатр(3). 
дей 1 3 " - + изег. иша хе 
ирдалей. а! Итезлатр(з). ех изЧод. иша хеж " ГО дейехед,ак птезгатр(а) 
дед „ивцод.иша хеж и 
1 деюка а цтезатр(з) тех пеж Г “ ИвЧга. иша: ем 
т -- ст заациз "вдатиз” г ; 
- расеуша теж : я огдег кедег 
| сащ зеж 
+ ша че “ “ (ша цех 
#9 расевемем ши | 
Г п 
2 тапа икедег ш в #8 изчпавабпа | # изнпайероп 
#8 РасеМвког ЩО сотега а #8 Расебегисе | СО гайодн имедег 3 
“ геавоп лежа 
# стеапой ах нтезтатр(з) + зашъ "вацие” +. сгоалой, ай Ипуезгатр(з) | #8 РасеТад + сгоапой ай Шпезцагор(З) па никои #8 иЦвупатад 
1. веелед ат итевтатр(3) #. стеадей а: тезгатрз) Г. веле, аг итезиатр3) е: р + ирдалей, а Чтезхатр(3) г я. 
” ” | „ расейша цех. р дейелед. а итозтатр3)  уврпа иша цех. 
> изегуша ек ирвале, а итезтатр(З) „ масеоща дек “ дейетед а Цтевгагорз) ” я 
и г; |  лавбищ тех в - изег. ла е оад-иий  пеж 
> расецша ек дейтей а пгпезтатр3) зегисейша лед изег-иша те знирии не 
1 щ ех 
О иша теж <.. изегуша дек ЕО поща ва | 3 пвбод даа ех , па 
«а н суша деж 
 расеуша леж: уша тех 
+ иша дек. 


фиг. 2.38. - Схема на база данни 
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2.51. “Таблица „Изег“ 
Таблица „Изег" се използва за съхранение на потребителските 


данни в базата данни. В нея се съдържат идентификатор, име, 
потребителско име, имейл адрес, телефонен номер, хеширана парола, 
роля на дадения потребител, неговата профилна снимка, снимка за фон, 
описание (биография) на профила, дата на раждане, кога е създаден и 
последно изтриван профила, както и дали са верифицирани имейла и 
телефона. Към тази таблица, както може да се види в модела на (фиг. 2.Ж.), 
има много връзки към таблиците, които съдържат цялото съдържание, 


създадено от потребителя 


тоде| Изег 4 
цита 
пате 
изегпате 
ета 
рпопе 
раззмога 
готе 
рго?11е р1с 
Ппеадег. ръс 
ото 
дате от Бугтп 
мегт 7 тед етаЦ | 
мег| Тед рпопе 
сгеатед ат 
цирдатед ат 
детеТтед а? 
сет 1 1пд5 
1151 1пд5 
1151 1пдСоттепз5 
1151 1лдзКаттпдз5 
1ъз1лдКерог?5 
спат5 
спат Пита 
Меззаде 
Р(асеСгеатог 
Р|тасейупег 
Р|(асеу1 51 Тогв 
Р|(асеКеутем 
Р|асеКерог? 
Изегбамейд! 1511пдз 
ИзегбамедРтасе5 
изегз гатТед 
изегз гатед Тгот 


51г1па 

51 г1па 

51 гтпа 

51 г1па 

51 г1па 

51 глад 

Кое 

51гтпа 

51 глада 

51г1пад 
ОатеТт1те 
ВооТеап 

ВооТеап 

Оатет те 

Оатет те 
Оатет1те 
Изегбе?т 1 1пд5 
Гъзътла |) 

1151 1лдСоттеп+ Г 1 
Цъз1ллдкаттла | 1 
Цъ51лдкерог?+ | 1 
спа 1 

51гтпа 
Меззаде | 1 
Ртасе|1 

Ртасе|1 
Ртасеут5ттог! 1 
Ртасекеутек | | 
Р|асеКерог? | 1 
Изегбамед! 1511паз | 1 
ИзегбамедРтасез | | 
УзегКка?ттпа! 1) 
УзегВва?тпа | 1 


фиг. 2.39. - Модел на таблица „Озег" 


19 вдеташ + (чита()) 


ипТаче 
ипТаче 
ипТаче 


детаи1 + ( И5ЕК) 


деташ1 + ( пом()) 
деташ 1 1 ( Та зе) 
деташ1 1 ( Та|зе) 
детаи1 + (пом()) 
деташ + ( пом()) 


геТтаттоп( "Изе 


геТтаттоп(" 


геТтаттоп(“ 
гетаттоп(" 
гета? топ(“" 


гета? Топ( 


цирдатеддт 


1511пд5") 


Спа! Изегв" ) 


2.52. Таблица „15Чпа“ 


Таблица „151па" се използва за съхранение на информацията за 
всяка обява в базата данни. В нея се съдържат идентификатор, заглавие, 
описание, местоположение за среща (което се изразява в точни 
координати), тип на дадена обява, цена (нормална или под наем, или и 
двете), състояние на продукта, възможност за договаряне на цена, статус 
на обявата, както и обикновените времеви полета за създаване, промяна 
и издиране. Таблицата има връзки за създател, категория, снимки, 
коментари, оценки, сигнали, тагове (много към много) и запазвания от 


потребители. 


фиг. 2.40. - Модел на таблица "випа" 


2.55. Таблица „Сатедогу“ 


Таблица „Сатедогу" се използва за динамично създаване на 


категории в уеб приложението от администратор. В таблицата се 
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съдържат идентификатор, име, нормалните времеви полета, циклична 


релационна връзка към категория (която се използва за подкатегории) и 


връзки към обяви. 


тоде| СаТедогу 4 
чота 
пате 
сгеатед ат 
ирдатед ат 


дететед ат 
рагепт 

рагеп иита 
5ир саТтедог|ез 
1151 1п95 


5ъгтпа 

51 гтпа 
ОатеТттте 
ОатеТтте 
Оатеттте 
СаТедогу 
51гтпа 
СаТтедогу | 1 
гъза | 1 


19 вдеташт( ишта()) 


детаи 1 т( пом()) 
детаи1 т( пом()) дирдатеддАт 


гета?топ Тез", 1е195: Грагеп ии19|, ге?егепсез: 


гета! 1оп(" 


фиг. 2.41. - Модел на таблица "Сагедогу" 


2.54. Таблица „5Ппа!гпаде" 


Таблицата „ПзПпа!гпаде" се използва за съхранение на линковете, 


алтернативния текст на снимките и тяхната подредба. Освен това тя 


съдържа статус и обикновените времеви полета. Има връзка към таблица 


със снимки, която е много към едно. 


тоде| 1151 1лдтт 
чита 
игъ 
а1т 
огдег 
5Татиз 
сгеаТтед ат 
ирдатед ат 
детеТтед ат 
1111 ла 
1151 1ла чита 


аде 4 
5ъгтпа 
51ъгтпа 
51г1па 
111 
5Татиз 
Оатет те 
Оатет1те 
Оатет1те 
гъз 1ла 
51г1па 


19 адеташ(ччта()) 


деташ + (РИВЕТС) 
деташ + (поу()) 
деташ т( пом()) дирдатеддт 


гета? 1оп(Т1е195: 1151519 ишШа|, гетегепсез: |иц1я|) 


фиг. 2.42. - Модел на таблица „Изипо!таде“ 
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2.55. > Таблица “151паТааз" 


Таблицата „ПзПпаТад"” се използва като междинна таблица за 
създаване на много към много връзка между таблиците „Пзипа" и „Тад". 
Това обикновено може да бъде постигнато в Ризгпа ОНМ, като тя 


автоматично генерира такава междинна таблица, но целта е за бъдеще да 


се добавят други полета. 


фиг. 2.43. - Модел на таблица „ПзипдтТаз” 


2.56. Таблица “Тазд" 


Таблица „Тад" се използва за съхранение на тагове, за да бъдат 
преизползвани, ако вече съществуват, за да се спести място за 
съхраняване, повтаряне на данни, както и улеснено индексиране. 
Таговете съдържат идентификатор, име, което може да е само уникално, 


статус и обикновените времеви полета, както и с много към много връзки 


с места и обяви. 


фиг. 2.44. - Модел на таблица „Тад”" 
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2.57. Таблица “15ппаСотгпеп?" 


Таблицата „ПзйпаСогатеп?” се използва за коментарите под 
обявите. В нея се съдържат идентификатор, съдържание, статус и 
обикновените времеви полета. Таблицата е с връзки едно към много с 


таблиците „Изег" и „Пзйпа". 


фиг. 2.45. - Модел на таблица „ИзипаСоттеп?" 


2.58. Таблица “зипаВачпа" 


Таблицата „|151паВа па” се използва за оценяване на обяви / 
услуги. Тя прилича много на „ПзйпаСопттеп!, но с две значителни 
разлики - вместо със съдържание, тя разполага с рейтинг. Освен това е 
създаден уникален индекс, позволявайки на един потребител да поставя 


само една оценка за един пост. 


фиг. 2.46. - Модел на таблица „1випаобватта” 


ВЕ 


2.35.9. Таблица “Расе" 


Таблицата „Расе" се използва за съхранение на информацията за 
всяко място в базата данни. В нея се съдържат идентификатор, име, 
описание, локация, иконка, статус и обикновените времеви полета. Освен 
това има връзки за създател, собственик (ако е посочен такъв) категория, 
снимки, услуги (много към много), ревюта, сигнали, тагове (много към 


много), хора, които са посещавали, и запазвания от потребители 


тоде| Р|асе 4 
цила 51 глад Т9 адеташт(иита()) 
пате 51 глад 
дезсгтр?топ 51г1па 
саТтедогуйита 5Ъгтпад 
саТтедогу РтасеСаТтедогу гета? Топ(?1е1дз: | сатедогуШи19|, гетегепсез: |иц1яЯ|) 
та Етоат 
1па ЕТоат 
Тсоп 5Ъгтпа 
5Татиз 5Татиз детаиш1 + ( РИВ-ТС) 
сгеатогИита 51 гл 
сгеатог Изег гетаттоп(Т1е1д95: |сгеатогшяЯ|, гетегепсез: |чшяЯ|, пате: 
геатог") 
омпегуита 51ъгтпа 
омпег Узег гетаттоп( 1е1д95: |оипегйит9|, гетегепсез: |иш19|, пате: "Р1ас 
сгеатед ат Оатет1те детац 1 + ( пом()) 
ирдатед ат Патеттте детаи1 + ( пом()) дирдатеддт 
дететед ат ОатеТттте 
зегу1сез5 Р|тасебегутсе| | 
Ттаде5 Р|асеТтаде! | 
Тад5 Р|асеТад! 1 
геутем5 Р|асевемтем | 1 
герог?в Ртасекерог? | 1 
мъб1Тога Ртасеу15ттог | 1 геТта?ттоп( "РТасеМ151+огв") 
ИзегбамедРтасез ИзегбамедРтасез || 


иптаче( Па, 1па|) 


фиг. 2.47. - Модел на таблица „Расе" 


2.510. Таблица “РасеСатедогу" 


Таблицата „РасеСатедог/" е изградена по подобие > на 


? 


„НяйпаСатедогу" само че с връзка много към едно към таблица „Расе" 
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вместо „Пзипа". Тя притежава същите полета и циклична връзка за 


подкатегориите. 


тоде| Р1асеСаТтедогу 4 
цота 51г1тпа 14 вдеташ + (иша()) 
пате 51г1пд 
5Ттатиз 5Татиз деташ1 1 ( РИВГТС) 
сгеатед ат Оатет1те деташт( пом()) 


ирдатед ат ОПатеТттте деташ 1 (пом()) дирдатеддт 

дететед ат Патет 1те 

рагепт Р|асеСаТтедогу геТтаттоп( "5 5", Р1е1д5: Грагеп! пий, гетТегепсез: 
рагепт иита 51г1па 

рТасе5 Ртасе|1 

5ир саТтедогтез РТасеСаТтедогу| | дгета?топ( "5ирСаТтедог|ез") 


фиг. 2.48. - Модел на таблица „РасеСагедогу” 


2.31. Таблица “Расебегмсе" 


Таблицата „Расебегике", по подобие на „|15ПпаТадз" се използва като 
междинна таблица за създаване на много към много връзка между 


таблиците „Расе" и „зегмсе". 


тоде1 РТасебегм1се 4 
цита 51 г1па 14 вдетаи 1 + (иита()) 
сгеатед ат Оатет те детаи1 + ( пом()) 
дететед ат Оатет те 


рТасе Р(асе гета? топ(?1е195: Гртасейи19|, гетегепсез: |иц1а|) 
рТасейита 51ъг1пд 

5егутсе 5егм1се гета? 1оп( #1е195: |зегутсейи14|, гетегепсез: | оц!) 
зегутсейита 51 г1пд 


фиг. 2.49. - Модел на таблица „Расебегике" 


2.512. Таблица “5егмсе" 


Таблицата „5егмсе" се използва за динамично създаване на услуги в 


уеб приложението от администратор. В таблицата се съдържат 
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идентификатор, име, иконка, статус и нормалните времеви полета. 


връзки към обяви. 


тоде| бегм1се 4 
чота 51г1пд 
пате 51г1пд 
Тсоп 51г1па 


зТатиз 5Татиз 

сгеатед ат ОПатеТттте 
ирдатед ат ратет те 
дететед ат ОПатеТттте 
Ртасебегу1се РТасезегу1се| 1 


фиг. 2.50. - Модел на таблица „зегисе” 


14 вдеташт(ишта()) 


детаи1 + ( РИВЕТС) 
деташ1 т( пом()) 
деТтаи1 т( пом()) дираатеддт 


2.515. Таблица “РНасегпаде" 


Таблицата „РМасегпаде" е изградена по подобие на „15 па! гпаде" 


само че с връзка много към едно към таблица „Расе" вместо „ПзПпа". Тя 


притежава същите полета. 


тоде| РТасеТттаде 4 


цита 51 гтпа 194 адеташ 1 (ицта()) 


угъ 51 гтпа 
алт 51 гтпа 
огдег 10 


5Ттатиз 5Татиз детаи 1 + (РИВЕТС) 
сгеатед ат ОПате 1те детаи1 т( пом()) 
цпрдатед ат Оатет те детац 11 ( пом()) дирдаТтеддт 


дететед ат Пате те 


р|асе Ртасе гета? 1оп( 7 1е145: 


ртасешта4  51г1пад 


фиг. 2.51. - Модел на таблица „РМасетаде" 


2.514. Таблица “РасеТаз" 


ГртасейитЯ|, гетегепсез: 


Таблицата „РасеТаз" е изградена по подобие на „|159падТад" само че 


тя се използва за много към много връзка между таблиците „Расе" и „Тад" 


Поти 


вместо таблиците „ПзЧпа" и „Тад". Тя притежава същите полета и 


уникална индексация, за да не се повтарят таговете в един пост. 


фиг. 2.52. - Модел на таблица „Расетаз” 


2.55. Таблица “Расемвког" 


Таблицата „Расемвког" е помощна таблица, подобна на таблиците 
за запазване на обяви и места, за изграждане на връзка между 
потребител и място. Тази връзка се използва, за да потребителя да може 
да се отбележи, че е бил на дадено място. Тя съдържа идентификатор и 


времеви полета за създаване и изтриване. 


фиг. 2.53. - Модел на таблица „Расеувтог" 


2.56. Таблица “РасеБВемему”" 


Таблицата  „РасеНемеуу" е изградена по > подобие на 


„НяйпаСогоглеп!, обаче с връзка едно към много с таблица „Расе" и 
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връзка към таблицата „ИПзег". В таблицата се съдържат идентификатор, 


оценка, коментар (ревю), което не е задължително, статус и обикновените 


времеви полета. 


тойе1 РТасевемем 4 
чита 51г1па 19 адеташт + (ишта()) 
гаттпа 11 
соптепт 51г1пд 
зТати5 5татиз детац1 6 ( РИВЕТС) 
сгеатед ат ПатеТттте деТташ1 1 ( пом()) 
ипрдатед ат ОатеТт1те деташ т( пом()) дирдатеддт 
детеТтед ат ОатеТтте 
изег Изег гета? 1оп(?1е195: |изегши19|, гетегепсез: 
уизегуита 51г1пад 
рТасе Р|асе гета? топ( Т1е1д5: Груасейши 191, геТтегепсез: 
ртасейита 51ъгтпа 


ипТаче( ГртасейШит4, изегбита|) 


фиг. 2.54. - Модел на таблица „Расевемеу/”” 


2.517. Таблица “Шзегбамедзипаз" 


Таблицата „ПзегбамефШзипаз" се използва като междинна таблица 


за създаване на много към много връзка между таблиците „Изег" и 


„Пзппа". Тя съдържа и времеви полета за създаване и изтриване, като 


целта е запазените обяви да се извлича, сортирани по дата на създаване. 


тоде| Изегбауед! 1511п95 4 
цита 51г1па 19 адетаи1т(ицта()) 
сгеаТтед ат Патеттте детаи 1 1 ( пом()) 
де|еТтед а? ОатеТт1те 
изег Изег гетаттоп(1е195: |изег ии19|, гетегепсез: |ичъя|) 
изег цита 51г1па 
111 1ла Дъ 1ла гетатТоп(?1е195: |11511п9 ич19|, геТегепсез: |иц1я|) 
1151 1ла ичтд 51г1пад 


иптаче( |изег чит9, 115: 1пд. чша|) 


фиг. 2.55. - Модел на таблица „Озегзауеашвипоз” 
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2.518. Таблица “|)<егбамедРасез" 


Таблицата „ОзегбамедРасез" е създадена по > подобие на 


„Узегбамедшзипаз" само че за между таблиците „Изег" и „Расе". 


фиг. 2.56. - Модел на таблица „ИПзегбауеаРасез”" 


2.519. Таблица “Шзегва па" 


Таблицата „ИОзегнайпа" е създадена по подобие на таблица 


„Н5ппаВайпа"“, но за оценяване на потребители от други потребители. 


фиг. 2.57. - Модел на таблица „ИПзегвайпа”" 


2.5.20.Допълнителни таблици 


Допълнителните таблици са извън заданието на дипломната работа 
и не се използват в текущата версия на софтуерния продукт. Те са 


създадени с цел за бъдещо развитие на проекта. 
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2.5.201. > Табли 


тоде1 Р(асеКерог? 4 
чита 51г1па 
геазоп 51г1па 
сгеатед ат Пате те 
де|етед ат ОатеТтте 
изег Узег 
изегиита 51г1па 
р|асе Р(асе 
р|тасейит4 51г1па 


фиг. 2.58. - 


2.35.20.2. Табли 


тоде| 1151 1лдВКерог? 4 
чута 51гтпа 
геазоп 51гтпа 
сгеаТтед ат Оатет1те 
дететед ат Оатет1те 
изег Изег 
изег пита 51гтпд 
111 |ъз11ла 
1151 1лд ши14 51г1па 


фиг. 2.59. - Модел на допълнителна таблица „|15ипдобвероп" 


ца “РасеВвероп!" 


19 адетай 1 + (иша()) 
детаит + ( пом()) 
гетаттоп(?1е95: |изегШштЯ|, гетегепсез: |ичъЯ|) 


гетаттоп(Т1е195: Гртасеши19|, гетегепсез: |иц1Я|) 


Модел на допълнителна таблица „Расебвероп”" 


ца “51паВероп!" 


19 вдеташ + (иита()) 
детац 1 + ( пом()) 
гета? топ(1е45: Гизег иши19|, гетегепсез: |иш1я|) 


гетаттоп( Т1е145: |1151лад иш19|, гетегепсез: |чч1яЯ|) 


Е 


2.520.5. Таблица „ИПзегбешпаз" 


тоде| Ибегбет + 1пд5 4 
чута 
ргетеггед Тпете 
тагКкет па ета 15 
1п. арр. по 1 1саттопа 


ета 1 по 1 1саттопя 
сгеаТтед ат 
прдатед ат 

дет етед а? 

изег 

изег пита 


фиг. 2.60. - 


51гтпа 14 вдеташт 

51гтпа детай 11 ( "1тапт 

ВооТеап деташ т (Тгие ) 

ВооТеап деташ 1 (Тгие) 

ВооТеап деташ 1 (1 гие) 

ОатеТт1те детаци 1 + ( пом()) 

Оате те деташ т( пом()) дирдатеддт 

Оатет те 

Изег гета? топ( ?1ед5: |изег иит9|, гетегепсез: |ичъЯ|) 
51гтпа ипТаче 


( 
( 


Модел на допълнителна таблица „Озегбетипоз” 
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2.3.204. Таблица “Спа? 


фиг. 2.61. - Модел на допълнителна таблица „Сват” 


2.5.205. Таблица “Меззаде" 


фиг. 2.62. - Модел на допълнителна таблица „Меззаде" 


2.5.21. Изброени типове 


2.5.21.. Изброен тип „Ное“ 


Изборният тип "Ное" се използва в таблицата с потребители за 
определяне на ролята и правата на даден потребител. В базата данни има 


3 типа роли - обикновен потребител, модератор и администратор. 


фиг. 2.63. - Модел на изброен тип "пое" 
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2.5.21.2. Изброен тип „зтате“ 


Изборният тип "Тате" се използва в таблицата с обявите за 
определяне на качеството и запазеността на дадено оборудване. В базата 


данни има 4 типа на състояние - ново, като ново, използвано и подновено 


/ ремонтирано. 


фиг. 2.64. - Модел на изброен тип "5таге" 


15 2.5, Изброен тип „зтатиз“ 


Изброеният тип "5Татиз" се използва в таблиците, които са за 
съдържание, създадено от потребител - обяви, места, снимки, тагове, 
коментари, услуги, ревюта, категории и услуги. Предназначението му е да 
се използва за статус на даден обект в базата данни - дали е публичен, 


или не. В базата данни има 4 типа статус - публичен, частен, премахнат и 


изтрит. 


фиг. 2.65. - Модел на изброен тип "5гатиз" 
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2.521.4. „Изброен тип „ПзипаТуре“ 


Изброеният тип "1аПпаТуре" се използва в таблицата за обяви за 
бъдещо развитие в предлагане в платформата не само на техника, но и на 
фрийланс“"!" услуги, свързвани с процеса по създаване на съдържание, от 
потребители. В базата данни има 2 типа обяви - обикновена обява за 


оборудване и услуга. 


фиг. 2.66. - Модел на изброен тип "1зипдоТуре" 


зе 


Глава |!!! 


Реализация 


Дипломната работа е логически разделена на две системи - 
сървърен софтуер (приложно-програмен интерфейс) и клиентски 
софтуер (потребителски интерфейс). Те са разгледани съответно в точки 
31. и 52. в тази глава. Показаните извадки код са само малка част от 
дипломната работа, като са извадени само обобщени (опростени и 
уеднаквени) и по-специфични, нетривиални такива. Пълният изходен код 
на двата проекта може да бъдат разгледани като приложение, на 
електронен носител, на тази дипломна работа или в облачните 


хранилища в СИНичР на следните интернет адреси: 


- Сървърен софтуер - ПИ рз//а ир.сога/кКокозТеспепя!епа-раскепа 
- Клиентски софтуер - АШ ре//айПир.сопу/коКкозТеспепяепа-оптепа 


31. Сървърна част 


3.1. Структура на файлова система 


Конфигурационните файлове от един проект са изключително 
важна част от неговата цялост, благодарение на тях този проект е 
стандартизиран, изпълним и дефиниран за други системи, освен 
локалната. 

- „епу е конфигурационен файл, който се дефинира на всяка 
локална система и не се разпространява чрез МС5. Използва се 
за съхранение на конфигурационни променливи, които или са 
различни за всяка система, или са поверителни. 

- „езип!идпоге и ргешепдпоге се използват за изброяване на 


пътища и > файлове, които да бъдат игнорирани от 
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инструментите за статичен анализ и форматиране - ЕЗПпЪ и 
Ргейег. 

„езипис и ргейетс са конфигурационни файлове, в които се 
отбелязват използването на разширения, стандарти и 
промени в правилата на инструментите за статичен анализ и 
форматиране - Е5ПпЕ и Ргешег. 

.ашапоге, по подобие на „езиппдпоге и „ргешепдпоге, се 
използва за игнориране на пътища и файлове, но за тяхното 
следене чрез СЕ - контрол на версии. 

лез-с!воп е “автоматично генериран (от Чез 95) 
конфигурационен файл за МезЩШ5, който може да бъде 
променян от разработчика. 

раскаде|5оп е конфигурационен файл за менажиране на 
зависимости с Моде > РасКкаде Мападег (мениджър на 
зависимости за софтуер, базиран на Моде.з). В него се 
конфигурират различни параметри на проекта като име, 
версия, описание, автор, лиценз, на каква версия на Мойе.)5 се 
изпълнява, както и различни скриптове, с които проекта 
разполага - примерно: стартиращ, компилиращ, форматиращ, 
тестващ и много други. В този файл са посочени и всички 
зависимости на проекта, заедно с техните версии, като отделно 
може да бъде посочен и специален софтуер за менажиране на 
зависимостите, заедно с неговата версия. В този проект се 
използва рпрга. 

рпрт-юскуат! е автоматично генериран файл, който не 
трябва да бъде променян от разработчика. Използва се за 
Следене на зависимостите от дадения мениджър на пакети. 
Подобни файлове има и от другите мениджъри - расКкаде- 


109.501п (пргл) и уагл.оск (уагп). 
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- Евсопйа.|воп и Езсопйа.бийазоп са конфигурационни файлове 


за Турезспр!, неговите версии, правила и настройки за 


компилиране. 


9 езипйдпоге 


1всоппа.риПд | 5оп 


| 1зсоп а.) 5 оп 


фиг. 3.11. Конфигурационни файлове във файловата структура на проекта 


- ойри6 - обикновено съдържа конфигурационни файлове и 


автоматизации за СИН ИБ, но в този проект се използва за 


конфигуриране на шаблони за СЕНИ |15зиез и Ри! Ведиез:. 


- рпвгла 


зсрета.ризта - конфигурационен файл за Рпзгпа ОНМ, 
който служи за дефиниране на моделите на базата данни 
и връзките между тях (разгледани в т. 2.5). Този файл 
използва специфичен за Рпзгпа синтаксис за описание на 
схемата на базата данни. 

пагайопвз - директория, в която се съхраняват всички 
миграции (генерирани от Рпивгпа). Те съхраняват под 
формата на 5 ОГ файлове. 

зеей 15 - файл, в който са дефинирани записи по 
подразбиране (предефинирани), когато се създава нова 


база данни. 


- вгс - директория, която съдържа целия изходен код на проекта. 


Структурата на повечето директории в нея е, че те са различни 


Дуа 


функционалности (модули) на МезШ5 приложно-програмния 


интерфейс или обединение на няколко такива 


функционалности. 


ай - модул и функционалност за удостоверение и 
авторизация. 

сатедогу - модул и функционалност за категориите на 
места и обяви. 

сраг - допълнителен модул и функционалност, която не е 
част от разработката на дипломната работа - чат. 
соттоп - директория, в която се съхраняват споделени 
елементи, които се използват в проекта. Те могат да бъдат: 
декоратори, интерфейси, типове, грешки, филтри, 
интерсептори, Яо, споделени помощни функции и други. 
Ше - модул и функционалност, която се използва за 
създаване и достъпване на обекти в АУМ5 55. 

Изипа - модул и функционалност за обяви и услуги. В него 
се съдържа модул и функционалност за създаване на 
коментари и сигнали за обяви и услуги. 

тай - допълнителен модул и функционалност, която не е 
част от разработката на дипломната работа - има за цел да 
бъде използван за изпращане на имейли > за 
потвърждаване и изтриване на профил, както и 
нотификации при получаване на нови съобщения 
посредством вградената чат система. 

расе - модул и функционалност за места. В него се 
съдържа модул и функционалност за създаване на 


ревюта, сигнали и услуги за места. 


ривта - модул за споделената бизнес логика и 
конфигурация - Рпизплабегмсе, чрез която > всички 
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елементи от бизнес логиката на приложение (бегмсе) 
имат достъп до една инстанция на Рпзглабегисе чрез 
инжектиране на зависимостите (Перепдепсу |песпоп). 
Използва се за правене на заявки до базата данни. 

гед!5 - модул за споделена бизнес логика и конфигурация 
- Вед155егисе, изградена и използвана по подобен начин 
като Рпвгпазегисе. 

гезоигсе - модул и функционалност, която се използва 
вътрешно в приложение, за проверка на права на достъп 
до даден ресурс 

зеагсп - модул и функционалност за търсене на 
потребители, обяви и места. 

Гад - модул за тагове, които се използват за обяви и места. 
изег - модул и функционалност за потребители. Тя 
разполага както със собствен контролер, така и се 
използва в модула за удостоверение и авторизация. 
арр.тояйше - главният модулен файл на едно Мез05 
приложение. 


тат. (5 - главният файл на едно Мез 05 приложение 


сеч: - директория, в която се съдържат различни Оп! тестове за 


проекта. 


В повечето модули и функционалности се съдържат файлове и 
директории като: контролери, бизнес логика (зегисе) - резолвър, 
множество дТо, типове, селектори (за Рпзгпа) и други. Те биват разгледани 
в по-долните точки в тази глава. 

Структура и обобщение на файловата система могат да бъдат 


разгледани в изображението на фиг. 3.1.2. на следващата страница. 
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(2 епяепа-Баскепа 
Со айпиБ 
Са ривта 


Ото 


В <еед.15 
З) згс 
Паши 
(9 сагедогу 
3 спа: 
СЗ соттоп 


С Пе 


Со изипа 


ОС та! 


в тпап.15 


О1ез: 
фиг. 3.1.2. - Директории и част от файловете в структурата на файловата 


система на проекта 


3.1.2. Конфигуриране на връзка и достъп до базите данни - 


Розтагеб5 ОГ с Ривгла и Нед!5 


За да може да се правят заявки към базата данни, трябва да се 
конфигурира и създаде инстанция на Рпзгпа, която да се използва в 
приложението. Тази логика се нарича „Рп5гпа бегисе", която унаследява 
класа РпзгпаСПеп!, който е генериран от Рпвппа с „рПзгпа депегате" или на 
всяка миграция, направена с Рпзгпа. Рпвзгла 5егисе имплементира и 


Мез05 интерфейсите при инициализация и разрушаване на модула, в 
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които се извикват методите на РпзгпаСПеп! за свързване и отвързване от 


базата данни. 


(с) 


РгъзтаС|тепт 
ОпМодитетпт +, ОпМодиТ ебезтгоу 


фиг. 3.13. - Ризта бегике 


Заявките в Рпзгпа се правят с извикване на Р/5ппа5егисе инстанция 
и метод на всеки модел като ппаМапу, ппайпаче, ПпайЦпачеОгтТАгом и 
други. Тези методи приемат много различни аргументи, като един от тях 
е „зейесГ. Той се използва за избиране и вземане само на дадени полета 
от модел и неговите връзки. Тъй като Ри/5втаС! еп! е генериран спрямо 
модела, методите и техните параметри имат строга типизация, което 
подпомага автоматичното допълване, както и предотвратява грешки за 


избирани на несъществуващи полета и таблици. 


фиг. 3.1.4. - Примерна заявка със зе!ес за избиране на полета 
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Това обаче създава един голям проблем и той е, че тези „зейесГ 
параметри стават много големи, повторяеми и неподходящи за методи от 
бизнес логиката (зегисе), затова за целта на този проект е създадена 
спомагателна функция, която се използва за създаването на типизирани 
сеесг обекти в отделни файлове. Функцията е депепс““”", като тя приема 
модел от РивтаСепг. Това позволява преизползването на зейест обекти, 


както и тяхното съхранение в отделни файлове и директории - „зейес!<". 


1трог! 4 Ргузта ) гот "вргзта 


ехрог! Туре СПпескоеТестКеуз<т, 4 
|(К 1п Кеуо? Т|: К ех! епд5 Кеуо? И : пемег; 


|: 


ехрог! сопз5! сгеаТебеТтест Т ехтепдз РгЪзпа. ипКпомп, ипКпомп>>( 
ага: СПесКкбе! естКеуз<т, Т>, 
) ага; 


фиг. 3.1.5. - Подпомагаща функция сгеотезеес)) 


На фиг. 3.1.6. е показан примерен зе!ес! обект за избиране на снимка 


от обява. На функцията се подава модела, който е взет от Ризта(С еп! за 


Пзипотаде. 


1прогъ ( Ргвша | Екош " рг15ша/сШеп+"; 


1прогъ (| сгеатебетесъь ) Егот !../../сошшоп/1+115/сгеатебе1ес+" 


, 


ехрогъ сопзЬ 11511паТшадеветес+ сгеатедетесът<Рг1тзта.115811паТпадебе1ес+> (4 
: стие, 
:: Етиое, 


з Екое, 
: Егче, 


фиг. 3.1.6. - Примерна употреба на сгеатезе!есц)) 
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Връзка с базата данни, допълнителни конфигурации и разширения 


се дефинират в рпзгпа.зсПпегпа файла. 


фиг. 3.1.7. - Връзка с базата данни, избор на нейния тип (Розтдге5 ОГ) и 


добавяне на функционалност за търсене (Е! тех! зеагс!) 


За да може да се правят заявки до Нед! базата данни е създаден 
клас с бизнес логика - Вед/!55егисе. В него са създадени 3 метода, които 
са нужни за създаване, намиране и извличане на всички записи в базата 
данни. Тези методи са използвани в методите за удостоверение и 
авторизация. 

Методът зе!ех() приема три аргумента - ключ, стойност, които са 
стрингове, и време за живот на записа (1), което е число в секунди. В този 
метод се извиква зе?Ех() метода на Кед!5 клиента, който е инициализиран 


в Вед!55егисе. 


фиг. 3.1.8. - Метод зе ех() от Вед!в5егисе 


Методът деЦ) приема само един аргумент - ключ, който е от тип 
стринг, като връща Ргопиве от стринг или пи! стойност, ако е неуспешно 


изпълнен. В самия метод се изпълнява едноименната функция за Нед!5 
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клиента - деЦ), която приема същия тип аргумент. Неговата стойност се 


връща. 


фиг. 3.19. - Метод деЦц) от ВКед!55егисе 


Освен това в Вед155егисе е създаден и метод за извличане на всички 
ключове, техните стойности и оставащ живот в един голям списък, 


наречен детд!!), който не приема никакви аргументи. 


фиг. 31.10. - Метод детА||) от Вед!55егисе 


По подобие на Р/в"табеги!се, Нед!55егм!се е клас, създаден за достъп 
до Нед! базата данни. Неговата конфигурация може да бъде видяна на 
фиг. 3.1.11, която се намира на следващата страница. В нея се използва 
Сопйпдабегисе - услуга, предоставена и вградена в Мез5, за извличане на 
данни от епм конфигурационен файл. Тя разполага с методите дет и 
де ОГТ!гоуи, които са силно типизирани. Като де ОгГРгоуи спомага, ако 
дадени конфигурационни стойности не са зададени, да не се стартира 


приложно-програмния интерфейс. 
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е ()) 
ехрог? с|а55 ТтрТетепт5 ОпМодишетп1 +, ОпМодитеез?гоу 4 
рг1уате геадопу сеп: гед15.Кед15С|ТепТТуре; 


соп5з гистог( рг1уате геадопту : Соп! 1дбегу1се) 4 
111з.с еп? < „сгеатеб1теп+ (4 
чг.: ЪАЪб.соп? Та. дет ОгТ!Нгом<5 + г1па>( |: 
соске?: 4 
соппес? 1 теочт: 5 
поеТау: 
КеерА| Туе: 
гесоппест5Тгатеду: ( ) > „тъп( 
> 
изегпате: Е115.соп? 1. детОгТПгом<5?г1пд> ( 
раззмогд: Е15.соп? 1. дет ОгТПгом<51г1пд> ( 
пате: 1115.соп? Та. детОгТ!гом<5?г1пд> ( 
даТтабазе: 1115.соп? Та. дет <питег> ( 


В 

111з.с еп. оп( 
а 
111Ъб.сЦеп+.оп( 


В; 
) 


азупс () 
ама 1115.сЦеп?. соппес(); 


: ци 


азупс (Ора 
ама 1Н15.с еп. ф15зсоппес(); 


фиг. 3.1.1. - Конфигурация на Вед!55егиксе и инициализация на Ред!56 СПеп? 


51.5. Конфигуриране на услуга за качване на файлове 


Проектът разполага с услуга на АММ5 53 за качване и четене на 
файлове за обяви, места и потребители. В нея се съдържат както 


контролер, така и обслужващ слой, типове и няколко до. 


> Пе 
“ ОП оз 
в Не.д10.15 
В гезропзе-е.д!0.15 
У Гепитв 
(В ас|.епит.!5 
68 ПеТуре.епит.45 
те Пе.сопгойег.врес. 1 
68 Пе.сотгойеглв 


#8 Не.подше.15 


(2 Пе.зег/се.зрес.15 


#8 Пе.зегисе.15 


фиг. 31.12. - Файлова структура за функционалността за качване на файлове 
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В обслужващия слой ЕПебегисе се инициализира АУМ5 53 клиента., 
като за него се задават регион и 2 ключа за достъп, които се взимат от 


Соппдабегисе, при липсата им - приложението няма да стартира. 


: 5ЗСЛеп; 


: Соп? 1дбегутсе) 4 


(4 


5Ъг1пао> ( 


51 г1па> ( 
51 г1ла> ( 


фиг. 3.1.13. - Конструктор на ЕПезегисе и инициализиране на 53 


ЕПебегисе съдържа само един метод - ироайие|), който приема 
файлови параметри и потребителски идентификационен номер, като 
след това се създава уникален ключ (път) за файла, който ще бъде 
съхранен в 55 кофата. Този ключ се състои от главна директория, 
директория за потребителя, уникално генериран ключ и нормалното име 
на файла. След това се създава обект с параметри на обекта, в който се 
съдържат публичността му, името на кофата, ключа, типа на файла и 
метаданни - потребителски ключ, след което се изпълнява РОТ команда 
и се взима готов ОН! адрес, който има изтичащ период от 5 минути за 
качване файла. След това методът връща ОН! за качване, ключа и 
публичен ИНГ, който да се използва и съхранява в базата данни. Методът 


е описан във фиг. 3.1.14., която се намира на следващата страница. 
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азупс ир|оадРЦ1е( 
Е ЛеРагатз: ЕЦЛейто, 
изегишта: з5ЪгЪпад, 
): Рготузе<КезропзеР Тейто> 4 
4 пате, Туре, ас | - ЦеРагатз; 
соп5? Кеу Ф( 11. Е (С Аме ОГОЕК") )/54изегуитЯ?/ 4 иита()-44 


соп5 рагат5: Рит0Б)есТКедиезт 4 
з ее : <Ъг1па> ( 
: Кеу, 
засто 


: изегуита, 
ра 
РР 


соп5 1 соттапа пем Ри 0Бт ест Соттапя( рагатз); 

соп51 иг| ама: дет5топедиг 1 (111з. „| соттапа, 
ш6Ш 5, 

Те) 

соп5Е рис иг| Ф1 115. я 51 г1па>( 


гетигп 4 


фиг. 31.14. - Метод ироаЯйие|) на ЕПезегисе 


За качване на файл се използва контролер с път „ИПе/цроай", който 
изисква потребителят да е с акаунт. Като се приемат заявки от ОН! адреса 


- име на файл, тип на файл и публичност. 


Соп го 1ег( "Е Де") 
АртТад5 ("Ле") 
АртВеагегАцтй() 
Изесциагдв ( Зу 1Аит снага) 
ехрог! с1а55 ЕЦеСопгоПег 4 
(ргууате геадопу ЕЛебегутсе: ЕЛебегутсе) 4? 


Сет ( " ир|оайд") 
Ар ВеагегАш+!() 


АртКезропзе( 4 
: 200, 
: КезропзеР ейто, 


+) 
ЕЕ а ( 
Кеа() гед: Кедиез И НО5вег, 
Очегу() диегу: ЕЛейто, 
): Рготузе<Кезропзер | ейто> 4 
гетигп 118. 1 (ачегу, гед. 


+ 


А 
т 


фиг. 3.1.15. - Контролер за качване на файлове 


св. 


Процесът за качване на файлове е описан на фиг. 5.6. 
паЗвчо, до. / од 


нота с 
Сва Щи. ч Ярт 


ГА мда уд иат см. 
“ геав- от |ч и 


-- 
/ - 
(|оцф гоа + 
м5 мас 
| 15 54 


фиг. 3.1.16. - Процес по качване на файл 


314. Обработване на ресурс, получен от интернет - проверка и 


верифициране на данни 


Обяснението е общо и важи за всеки модул и функционалност, 
които получават данни от интернет независимо дали е посредством 
параметри, заявки или тела (|50п). 

„Не може да се има доверие на потребителя“. Всички данни, които 
са подадени от потребителя, минават през валидация. Тя най-често и 
лесно минава през „с!аз5-мапдатог ррез. Като тази библиотека се 


използва за всяко едно Яо, което идва от потребителя (външния свят). 


фиг. 3.1.17. - Активиране на глобален Ргре за валидации 
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Най-добрият общ пример за такова дТо е 
„СгеатеРйасеОто" (фиг. 3.1.18.), което се използва за 
създаване на място. В него се съдържат всички 
данни, за да бъде създадено едно място, подадени 
от потребител. 

За описание на изискванията за дадено поле 
се използват декоратори / анотации. В проекта са 
използвани част от следните, но има още много 
други, които могат да бъдат разгледани в 


: 5БЪГШО: 


документацията на С!а55-МаПаатог. ф 
() 


(255ипа() - да е стринг сащ, 

с МоЕтрту() - да не е празно 

С1епа!!(М, М! - да есдължина от М до М 

- аМасвез(Х, У. 2) - да съвпада на даден 
регулярен израз (Недех - Х). 

- (05000)-даейшо 

- о5айшое) и Г5Гопапидае - да са 


координати (в зависимост от посоченото) 
- (0Епит!|Х) - да съвпада с изброен тип Х сиааа 
- О5Апоу|/ -дае масив чи 
- (ООАггауМо! Е трту() - да не е празен масив 
- (ОАггауМах5оге|(х) - да е масив с Х 
максимален размер 
- Омтепа! (Х) и Махепа! !(Х) - да е с 


минимална или максимална дължина - Х 


- (Оо/5Митьре(!)- да е число 


: бтайис: 


(О) 


(16) 
с Ма 1 и Мах(Х) - да е число с минимална : ОДИ 


или максимална стойност - Х 


- (05РНопеМитрец) - да е валиден телефон фиг. 3.1.18. - СгеагеРасеОПто 
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31.45. Създаване на > потребителски профили, удостоверение, 


авторизация 


Една от най-важните части на приложно-програмните интерфейси 
е сигурността - дали даден потребител е авторизиран, когато трябва, 
дали има права за даден обект ит.н. 

Структурата на модула за удостоверение и авторизация е следната: 
в директорията "десогайогв" се съдържат различни декоратори за 
управление на права, които са разгледани вт. 5..6., в "Тоз" се съдържат 
шаблони за това, което сървъра получава от потребителя при влизане, 
регистриране и излизане. В "епифу", Чплтеггасез" и Чурез" се съдържат 
шаблони и типове, които се или връщат, или използват вътрешно в 
програмата. В "ачагдв" се съдържат няколко Мез0Ш5 дцагйз, а техните 
стратегии - в "5игатесиез". Този модул разполага с контролер и бизнес 


логика "зегисе". "сопзтап! в в" файлът съдържа УМУТ константи за модула. 


Сзаши 


в аи/.сопигойег.зрес.15 


аш!.тойше.15 


фиг. 31.19 - файлова структура на "Аи  " функционалността 


Както беше споменато в т. 2.23, в тази дипломна работа се 
използват УМУТ токени за авторизация. Подходът, който е взет, е да се 
използва т.нар. УУУТ Негезп" стратегия. При успешно влизане (или 
регистриране на потребител) се връщат "ассезз" и "евезП" токени. 
“ассезз" токенът се използва за получаване на достъп до даден защитен 


ресурс и за потвърждаване (авторизиране) на самоличността. Тъй като 
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“ассезз" токена се използва в изключително много заявки за авторизация, 
той подлежи на атаки и опити за кражба на достъп или самоличност. 
Поради това той е създаден да изтича за сравнително кратък период от 
време. И когато клиент се опита да извърши операция с изтекъл такъв 
токен, ще получи грешка, че е невалиден. Тогава клиентът трябва да се 
опита да направи т.нар. ротация и да поднови своя "ассезз" токен. Тук идва 
и употребата на "гейгезП" токена, той се използва точно за това 
подновяване и само тогава. Поради нечестата му употреба "гейгезп" 


токена има сравнително по-дълъг живот спрямо "ассезз" токена. 


Ке езп Токеп 


Ассез5 Токеп 


Ассез5 Токеп < 


Кезоигсе 
Зегмег 


Ба 


Сем 


Ргоесед Везоигсе 


фиг. 3.1.20. - "ассезз" - гегез!" токен стратегия 


За изграждане на тази система в Мез 5 се използва разширената на 
Разроп4з библиотека - "МезШ5  Разврот, и допълнителни 
функционалности от "раззрой-м!" библиотеката. За тази цел са 
изградени три файла "Сиага" и три стратегии. 

Първата стратегия се използва само когато потребителят се опита 
да влезе в своя профил - това е локалната стратегия. Тя е разширение на 
паспортната стратегия от библиотеката. В нейния конструктор се 
уточнява, че полето за потребителско име е "егпа!", вместо "изегпате", 


което е по подразбиране. Задължителен метод за класове, които 
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разширяват Раззроп5!готеду, е уапда!е(), който се използва за 
валидиране. В локалната стратегия се използва метода от бизнес 
логиката за сигурност - капдатейвек)), която намира даден потребител по 
имейл адрес. При успешно намерен потребител, функцията връща 


имейла и паролата, а в обратния случай - пи. 


азупс ма|1датейзег(ета |: 5Ег1пд, раз5: 51 г1пд): Рготбе<ипКпоуп> 4 
изег ама ТП1з.изегбегу1се. 1 пдВуЕта| 1 ( етат |); 


ТР (изег (ама! сотраге(раз5, изег. ))) 4 
гетигп 4 
: пзег. 
: цзег. 
ее 
+ 


гетигп пи; 


ц 


фиг. 3.1.21. - уапдагейзец)) 


При успешно валидиране на потребителя, стратегията връща 
върнатото от мапдагеЦзег)), докато при неуспешно валидиране на данните 


на потребителя се връща грешка. 


ТптесТав1е( ) 
ехрог! с1а55 Госа151гатеду ехтепд5 Раззрог?!5 7 гаТеду (57 гатеду) 4 
соп5з  гисТог(рг1мате аи! П5егутсе: Аит 5егу1се) 4 
зирег(4 : “ета|" )); 
+ 


азупс ма 1дате(изегпате: 51 г1пд, раззмогд: 5Ъг1пд) 4 


соп5 Е изег ама 1115. Я (изегпате, раззмогда); 


1 (изег) 4 
Тпгоу пем ИпаитпогтгедЕхсерттоп(); 


+ 


гетигп изег; 
+ 
+ 


фиг. 31.22. - Покална стратегия 


Стратегиите се използват при създаването на Мез 5 Сиагя. Като в 


този случай локалната стратегия се използва в локален дчагЯ - 
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“оса Ач НОцагя", който разширява класа "АийСцага", за да използва 


"оса!" стратегия. 


АиТпбиага( 


фиг. 31.23. - Покален Сиага 


Този адчага се използва само за вход на потребител в приложението 
в контролера за сигурност - "аш/одит". За използването на един или 


повече дцага се употребява анотацията "ПзеСиагаз" над метода на пътя. 


фиг. 3.1.24. - Метод 09") на пътя ай од" за Аш! функционалността 


Бизнес логиката зад пътя се намира в метода (од) - фиг. 31.25. и 
3126. В него се проверяват съществуването на потребителя и се 


сравняват паролите. Като при сбъркани данни се връщат грешки. 


фиг. 31.25. - Проверки в метода о9() 
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След това се връщат двата токена - "ассез5" и "егезй", Като 
информацията която се съдържа в "ассез5" токена е потребителския 
идентификационен номер, докато в "гегезй" токена се съдържат както и 
ИН, така и ИН на самия токен. Те се кодират с тайните ключове (един за 
"ассезз" токена и друг за "ейезп" токена), които се пазят в „епм 
конфигурацията на сървъра. Задават се и техните животи, които също са 
указани в конфигурационния файл (дължината на живот и тайният ключ 


са описани в Ач? модула при регистриране на УМУТ услугата). 


фиг. 3.1.26. - Създаване и връщане на токените в 109") 


Следващата стратегия е )МУТ стратегията. Тя се използва навсякъде, 
където са нужни данните на потребителя и се изисква потребителят да 
бъде с профил. Тази стратегия също разширява Раззро 5! гатеду класа, 
като приема модифицирано име - ЧмуГ. В нейния конструктор се 
определя откъде се взима УМУТ токена - от Ай?! хедъра на заявката, какъв 
е тайният ключ на сървъра, зареден от епм конфигурационния файл и 
дали да се игнорират изтекли токени, като в случая на този проект се 
игнорират, за да в СиагЯ да се върне специална (сизгогп) грешка. В 
задължителната уаПдате() се проверява съществуването на потребителя 
спрямо идентификационния номер на потребителя, който се съдържа в 


ЗМУТ токена. При ненамерен потребител се връща грешка, а в обратния 


сода 


случай се предават данните на потребителя към методите в 


контролерите под формата част от заявката. 


Тпуестабте( ) 
ехрог! с1аз5 Ом !:5Тгатеду ехтепдз Раззрог!5  гаТтеду(5 7 гатеду, "ум" 
сопз + гисТог( рг?туате изегбегу1се: Изегбегу1се) 4 
5ирег(4 


: Ехтгасъзмт. 
: ум ЕСопзтаптв. 
: Та зе, 
В); 
+ 


азупс ма|1дате(рау1оай: 4 19: 5Ег1па 5) 4 
соп5 Е изег ама 1115. с (рауТоай.19); 


1 (Гизег) 4 
сопз5о1е. (рауТоай); 
Тпгом пем ИпаитпогтгедЕхсерттоп(); 


+ 


гетигп изег; 


фиг. 3.1.27. - ТМУТ стратегия 


ЗУМТ Спнага, който разширява АиОшагЯ с персонализираната 
стратегия - УМУТ, в него единствено се прави проверка за невалиден 
(изтекъл) токен, ако той е такъв, се връща специална грешка за изтекъл 
токен. Този Сцага може да се използва Ф анотацията 


ОПзебиагаз Ом Аш Очатга). 


Тп)есТаб|е() 
ехрог? с1аз5 ЗМ АитНСиага ехтепйз Аитпбиага( ум") 4 
папдтеКедиез( 
егг: апу, 
изег: апу, 
1пТо: апу, 
соптех?: Ехеси?тТопСоптехт, 


5Татиз: апу, 
4 


4 

ТЕ (Ъп?о уозТапсео? Еггог) 4 

Тпгом пем ИпаицтногтгедЕхсер?ттоп( 4 
: “ТМУАГТО ТОКЕМ", 


КВ 
+ 


гетигп зирег. (егг, изег, ЪпТо, соптехт, зТатиз); 


фиг. 3.1.28. - ТУУТ Сиага 


-92- 


Последната стратегия, която се използва за токените се казва 
"Бетезй ЗМУТ 5тгатеду". Тя, по подобие на локалната стратегия, се използва 
само на едно място, но то е пътя за подновяване на "ассезз" токена от 
"гегезйп" токена. В тази стратегия само се конфигурира Раззроп51гатеду 
класа и се връщат данните, съхранени в токена - ИН на токен и 
потребител. Тази стратегия се използва в сходен (с изключението на 
персонализираното име, което тук е му -генезй") ацага, който може да 


бъде използван чрез анотацията Озебиагаз(Не!гез ми? Ошага) 


ТптесТабте( ) 
ехрог! с1а55 Кет гезП3)м 57 гатеду ехтепдз Раззрог!5 7 гаТеду( 
5Тгатеду 


сопзгистог() 4 
з5ирег( 4 
: Ехтгасъ 37. 
: ум Сопзтаптз. 
: Та|зе, 
ТЕ 
+ 


ма1тдате(рау1оай: 4 19: 5Еглло; ТокепТа: га )) 4 
гетигп 4 
: рауТоад. 
: рауТоай. 


фиг. 3.1.29. - Березй! ЛМТ стратегия 


Подновяването на токена се извършва чрез пътя “ацт/гекези". Този 


път е защитен с Ве!езП) ум Очатга. 


Се?(" гетгезп" ) 
Изебиагаз ( Ве? гезпмбиага ) 
АртОККезропзе( 4 


: АиТНЕпЪтту, 


+) 
азупс ге? гезТоКеп( ФКедиез?() гед: Кедиез ИТ ТоКкепТптегтасе) 4 
гетигп 1015. с (гед. „ча, гед- 


+ 


фиг. 3.1.30. - Път за подновяване на токени - аи! Н/генези" 
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Бизнес логиката зад този път се намира в метода гегезПТоКкепз)) - 
фиг. 3.1.31., която приема данните от токена - ИН на потребителя и самия 
“гетезп" токен. В метода се правят допълнителни проверки дали ИН 
съществуват и дали токенът е валиден, сравнен със списък от Вед!5 базата 
данни. Ако такъв токен съществува в черния списък, означава, че токенът 
е невалиден и се връща грешка. Повече информация за черния списък на 
токени и неговата логика може да бъдат намерени по-надолу в тази точка 
при обясненията за излизане на потребител. След това се прави заявка 
към главната база данни, в която се търси потребител по 
идентификационен номер, ако не бъде открит, се връща грешка. В 


обратния случай, се създава и връща нов, подновен "ассезз" токен. 


фиг. 3.1.31. - Метод гегез!Токепз() 


Тъй като на клиентския софтуер, регистрацията е многостъпкова, 
има три пътя за регистрация - първите два са само за валидация и 
потвърждаване на данни, както и проверка за конфликтни записи (дали 


даден имейл, телефон или потребителско име вече съществуват, както и 


а ГА 


за проверка на парола и потвърждаваща парола). Те са разделени на две 
стъпки - профилна (първа стъпка) и персонална (втора стъпка) 


информация. 


Ро51( "мат тда? ссоицпТ" ) 
азупс ма 1датеАссоип0ата( ФВоду() Бодйу: 51апирОпейто) 4 
гетигп 1115. я (роду, 1); 


+ 


Ро51( "матас а") 
азупс ма| 1датеРегзопатОата( аВоду() Боду: 51апирО+о) 4 
гетигп 115. : (роду, 2); 
р: 


фиг. 3.1.32. - Пътища за валидиране на данни и намиране на конфликти в 


многостъпкова регистрация 


азупс ма 1датебтдпир(роду: 51дпирОто | 51апирбпейто, 5 ер: питБег) 4 
1 (роду. роду. ) 4 
Епгом пем ВадВедиез+Ехсерттоп( 4 


НЕ 
+ 
соп5 ета ама 1115. 


1 (етал) 4 
+пгом пем Соп 1 стЕхсер?топ(<4 


соп5Т изегпате аматт 1115. 


1 (чзегпате) 4 
Епгом пем Соп? 1 1 стЕхсер?ттоп( 4 


г): 
и, 


три (5тер 2 Боду ЪпзТапсео? 
соп5? рпопе < ама 1115. 


1 (рпопе) 4 
Тпгоум пем А стЕхсер?топ( 4 


фиг. 3.1.33. - Проверка за конфликти на данни по време на регистрация 
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Третият път отговаря за самата регистрация - /аит/яапир". Данните 
за регистрация се приемат в тялото на заявката, а те биват: имена, дата на 


раждане, телефон, имейл адрес, потребителско име, парола и 


потвърждаваща парола. 


фиг. 3.1.34. - Път за регистрация на потребител - /аш!Н/запир" 


Самата логика се намира в метода ядпир), който е сравнително 
кратък, поради факта, че повечето логика за валидиране на данни е 


изнесена в горепосочения метод във фиг. 3.1.53. 


фиг. 31.35. - Метод з9пир() за регистрация на потребители 


Проблемът с излизането на даден потребител, използвайки 
текущата ОМУТ ВейезП технология без запазване на състоянието или 
използване на сесии, е, че "ге гезП" токените остават валидни дори след 
излизане, което не е ефект, който искаме, особено когато "гейгезп" 
токените са с дълга валидност от 7 до 50 дена. Това означава, че ако 


потребител излезе от дадено устройство, но си запази "гейгезП" токена, 
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може след това да го използва, за да си издаде "ассезз" токен. Това е 


потенциален метод за атака, който не трябва да се позволява. 


Жа Мостът на Йесезъ мъ Пе кеби С хем 


Побсо,, 14 
ба ъъщщщц 


(:! (: 


фиг. 3.1.36. - Разлика между времето на живот на 


пассезв" и гейез!" токените 


В тази дипломна работа се използва т.нар. "черен списък" за 
съхранение на "ге тез" токени, който цели да се съхрани простотата и 
бързината на системата без запазване на състоянието на потребителя в 
базата данни. Както е споменато вт. 2.214., за създаването на този черен 
списък се използва Нед!5, поради нейната бързина и възможност за 
задаване на време на живот на записите, подобно на бисквитките и УУУТ 
токените. 

В този черен списък се съдържат всички "ге! гезй" токени, които все 
още не са изтекли. Веднага след тяхното изтичане (когато 1! стане равно 
на 0), Вей! базата данни автоматично премахва записите, което намалява 


сравнително сложността и мястото, което се използва. 


Цумдаме ма хил бъчт Ол 


+ гсге 
ще аи аа К. спец Цутчссо. ма. 


Додте, 
ДС ла съкккеккска атеист таен къзтАтва 4. пембо. 


+ | 
А (, Процагксавра, е Бол цем, 1 ет пи 
Вар га КА 3 ча 


фиг. 3.1.37. - Логика зад създаването на черен списък и съхранението на 


"етез!" токени, които изтичат след примерните 7 дни 
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Излизането на потребител става чрез пътя "аш!Н/одоч?", като при 
него трябва да подаде както и двата токена в тялото на заявката, така и да 


подаде "гейггезП" токена като Ай лопгапоп хедър в заявката. 


фиг. 3.1.38. - Път за излизане на потребител - ай /одоч?" 


Бизнес логиката на този път се намира в |годочЦ) метода на Аитл 
5егисе. В нея първо се извличат данните от "егезп" токена - ИН на 
потребителя, токена и датата и часа му на изтичане. Проверява се дали 
потребителят съществува и дали "гейезп" токенът е валиден и не се 
намира в черния списък. Ако всичко това е изпълнено, токенът се записва 


в Бед! базата данни, заедно с неговия оставащ живот. 


р |: Ве?гез!ТокепТптегтасе 


( 


фиг. 31.39. - Метод юдочЦ/) 


- 98 - 


31.6. Права за достъп и модифициране 


Както беше споменато в т. 5.5. една от най-важните части на един 
ППИ е сигурността. В тази точка се разглежда втория аспект от 
сигурността - дали даден потребител има права за достъпване и/ли 
модифициране на даден обект. 

С цел създаване на система за роли и права, в приложно- 
програмния интерфейс е създадена бизнес логика за взимане на 
собственик на даден обект - обява, място, ревю или коментар. Както и два 


Мез 5 Сиагав - Вое Сиага и Регпп!5510п5 Сиага. Заедно с декоратори. 


Слаш 


- Па 


ше.15 


#в гезоигсе.зегиксе.15 


фиг. 51.40. Файлове, използвани за права за достъп и модифициране 


Декораторите са за изискване на роля или поставяне на изискване 
за даден ресурс и определено действие. 
Декораторът за роли приема тип роли, които са със стойности - 


"адгаит" (администратор, който може да прави всичко), "ппоЯ" (модератор, 
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който може да редактира или изтрива публикации) и "изег" (нормален 


потребител, който може редактира или изтрива само свои публикации). 


фиг. 31.41. - Декоратор за роли - Кое 


Декораторът (ОАсиоп се използва за означаване на даден път какво 
действие извършва. Този декоратор се използва от услугата за 
разрешения. Действията могат да бъдат - "Мем”" (да може да се гледа 
дадена публикация) и "гпападе" (да може да се редактира или изтрива 


дадена публикация). 


фиг. 31.42. - Декоратор за вид действие - АсПоп 


Последният декоратор, който се използва за създаване на тази 
функционалност е свързан с предишния - АсПоп. Ресурсния декоратор 
(Везвоигсе) се използва за посочване на какъв ресурс се изпълнява дадено 
действие. Трябва да се настрои, тъй като трябва да се знае в коя таблица 
трябва да се търси даден уникален ключ. Стойностите, които могат да 
бъдат използвани са: "15Ппа" (обяви и услуги), "расе" (места), "согпглепт" 


(коментари) и "гемем"" (ревюта). 


фиг. 31.43. - Декоратор за вид ресурс - Везоигсе 
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Горепосоченият декоратор за ресурси се използва с цел уточняване 
на дадения ресурс, който се използва в бизнес логиката за ресурси. Тя 
зависи от всички останали резолвъри (Бегмсе), които представляват 
даден ресурс, генериран от потребителя. Има само един метод, който 
получава ИН на дадения ресурс и неговия тип. Базирано на това извиква 


заявка към базата данни чрез дадения резолвър. 


1се: Сотп егу1се, 
е: Кеутембегутсе, 


: ВезоцгсеТуре, 


Я: 51г1пд, 


): Рготзе<КезоигсеСоп еп? 


( ) < 


фиг. 31.44. - Бизнес логика за взимане на метаданни за ресурси 


Услугите на този метод се използват от Рептвя0пз СиагЯ, който 
имплементира интерфейса СапАсПмайе, който допуска или не допуска 
изпълнението на методи от пътища. Този Сиагд зависи от вградения 


Вейестог клас и от Аи А и Незоцгсе услугите. 


СапАс?туате 4 


: Вет 1естог, 
се: Аи П5егу1се, 


е: Кезошгсезегу1се, 


фиг. 31.45. - Начална част от Регт!вз!опз Сиага 


ОП 


Създадени са няколко помощни метода за Реггпв510пз Сиага, най- 
главни сред тях бивайки - детОБестОмуипегАпазташе) и сап!|). 
деОестОуупегАпастатиф)) се използва за взимане на метаданните за 
обект. От рефлектора, който взима информация от зет Метадата()) - 
метаданни, приложени заедно с анотацията (ОНезоигсе, за типа ресурс, 
като след това избира кое ОЦ1О да използва за идентификатор на ресурс 
- иш9, ако е главен ресурс като обяви и места, или зиБ иша, ако е 
подресурс - коментари и ревюта. След това връща резултата на 


ПпаОпеМета() метода от услугата за ресурси. 


ВезоигсеТуре! 1>( 


е5Т: Кедиез ТИ 1ТПРагатита 
е емтем", "с еп" 1. 


фиг. 31.46. - Метод де: ОБ/гестОупегАпазтатиз() 
за изземане на метаданни на ресурс 


Преди да бъде разгледан сап() метода. Той зависи от помощен метод 
- де ШзегготкБедиез)). Метод, който проверява дали се е извършила 
вече проверка от /М/Т Сиага на приложението (съответно ако пътят е 
защитен). Ако не е, се очаква да се изземе от токена и да се направят 


проверки за валидност чрез де ШзегЕготтТокеп ). 


фиг. 31.47. - Помощен метод де: Шзегготбедиез() за изземан на потребител 
от заявка (независимо дали е минала през ЛМТ Сиага) 
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детШзегЕготтокеп |) е спомагателен метод, но от Аит И бегисе. В него 
се извлича ИН на потребителя и след това сравнява с базата данни - или 
ще върне пи!, ако такъв потребител не съществува, или ще върне цялата 


информация на потребителя, по подобие на ЗМУТ Сиага. 


фиг. 31.48. - Помощен метод де! ШзегЕготтТокеп |) за извличане на потребител 
От ТУУТ "ассезз" токен 


Помощният метод сап() взима както и контекст, така и тип на 
метаданни на ресурс (ИН, ИН на създател и статус на публикацията). 
Взима потребителя от заявката и ако няма такъв, връща грешка, че 
клиента няма права. След това проверява дали потребителят е 
модератор или администратор, ако е - връща истина. Ако не е, се извиква 
помощна функция - тоа! сй Оуупек), която сравнява ИН на потребителя и 


този на създателя на дадената публикация. 


фиг. 31.49. - Метод сап!() за преценяване 
дали даден потребител има права над ресурс 
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сапАсиуате() е булеви метод, който отговаря дали изпълнението на 
заявката може да продължи, или не. Това е метод, който се имплементира 
от интерфейса. Чрез рефлектора за метаданни се определя даденото 
действие, което потребителя иска да изпълни. Изземат се метаданните на 
обекта чрез спомагателния метод - ае Об/естОуипегАпабтатиз|) и се прави 
проверка дали такъв обект съществува. След това, в зависимост от 
избраното действие: 
- менажиране - веднага се извиква спомагателния метод сап). 
- гледане - първо се проверява дали дадената публикация е 
публична, ако е - всички потребители се допускат, ако не е - 


извиква се спомагателния метод сап). 


): 
АсТтопТуре! 1>( 


фиг. 31.50. - задължителен булеви метод сапАс!уате() за определяне дали 


додена заявка може да продължи или не 


Последният клас (и Сцага) за справяне със сигурността е Ро/е Сиага, 
който се използва за лимитиране на достъпа до пътища само до 
потребители с дадена роля. При използването на този Сиага, 
извикването на 7//Т Ай Сиага е задължително, тъй като се сравняват 


роли на вече съществуващ потребител в заявката. След изземането на 
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потребителя, се проверява дали ролята му присъства в списъка (подаден 
от се Мегадата|(), който е направен в декоратора Ро/ез), ако е - заявката 


продължава, в противния случай - приключва с грешка за авторизация и 


липса на права. 


СапАсЕТиате 4 
-: Вет естог) 4) 


ез: 5191, изегво|е: 51 г1па) 4 
((готе) ); 


г: Ехеси?ТопСоптехт): Боотеап 4 
5 гтпо | 1>( 


: Ведиез ТИТИ ег 


( 


фиг. 3.1.51. - Вое Сиага за допускане само на дадени роли 


351.7. Извличане на данни по страници (Радпапоп) 


Една задължителна функционалност, която модерните приложно- 


програмни интерфейси трябва да имат, е извличането на дадени данни 


по страници (Радпапоп) 


#8 радпапоп.15 


фиг. 51.52. - Файлова структура на "соттоп", където се държат част от 


файловете за Радпаноп 
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За разработката са създадени набор от типове, интерфейси, 
декоратори, както То и интерсептор на отговор, които се намират в 
“сотгпоп" директорията. 

Интерсепторът трансформира отговора, да следва стандарта на 
Рад паПоп. Ако данните вече са от тип РадпаПоп Незий Ото, следва че те 
ще бъдат върнати такива, ако пък не са, то те ще бъдат трансформирани в 


такива. 


() 


: 1 т 
Мез?ТпТтегсертог<Т, Радтпа ТопКезш1 10То<Т: 


( 
х1: Ехеси?ТопСоптехт, 
Е: Са Нап1ег<Т>, 
): ОрзегуаБ| е<Рад| па 1опКези 1 10 То<Т 4 

(6 ( 

((дата): 4 

ра! 
Радтпа? ТопКези1 10То<Т>; 


ипКпомп ЛЕ 


|: 


фиг. 31.53. - Трансформиращ интерсептор за Радтайоп 


Като резултатът, който се получава при всеки маршрут, който работи 
със страници, е следният: данни от общ тип, номер на страница (раде), 
брой елементи на страница (ай) и общо колко елемента има 


(гота! Сочп!;. 


з ШЩа 
(0 
: потБег; 
() 
: питБег; 
() 
: пуитбег; 


( га: Т1, раде: питбег, ЦмЕ: потвег, Тота Сошо: потбег) 4 


фиг. 31.54. - Шаблон за отговор със страници 
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В заявката, която се подава от клиента се съдържат следните 


параметри: номер на страница и брой елементи на страница. 


Кедиез? 4 


2 5Епипа: 
: 5ЪгТтпа; 


фиг. 3.1.55. - Заявка с разширение да поддържа аргументи за страница 


За да се улесни употребата на тези параметри, са създадени 
декоратори, които автоматично ги извличат в променливи, които връщат 


клас Радпайоп, съдържащ номер на страницата и бройката елементи на 


страница. 


Ха: ипКпомп, сЕх: Ехеси ТопСоптехт): 
: Радтпа ТопКедцие5 


фиг. 3.1.56. - Декоратор за извличане на параметри 


Освен този декоратор, са създадени още два с цел помощ за пълна 
и правилна документация на Ореп-АР! (която може да бъде посетена на 
Чадрес на сървъраМар") или още познато като бууаддег. Единият 


декоратор е за параметрите - страница и лимит, а другият е за връщането 


на отговор. 


фиг. 3.1.57. - Декоратор за документирани ППИ параметри за страници 


з307- 


фиг. 3.1.58. - Декоратор за документиран ППИ отговор за страница 


Така вече приложно-програмният интерфейс разполага с готов 
интерфейс и преизползваем код (само с няколко анотации) за 
разделянето на големите отговори по страници и намаляване / 
увеличаване на техния размер. Повечето примери за Радипапоп 
(поставяне на страници и лимити) могат да бъдат разгледани в СЕОО 
("Операции на...) точките в тази глава. Общо казано се добавят към Рпзта 
заявките Таке (лимит) и зЖр (колко да бъдат пропуснати - изчисление 


между текуща страница и лимит). 


318. Обработване на грешки и форматиране на отговор 


Както беше обяснено в т. 2.2.6., в Мез5 филтрите се използват за 
обработка на грешки. В този приложно-програмен интерфейс трябва да 
се обработват 3 основни типа грешки - от валидация (след неспазване на 
оказан тип в ОТО), от Рпзгла ОВМ (при грешки в заявките - несъществуващ 
запис, липса на параметри, конфликти и други), както и всички останали 
грешки, които или са програмирани да бъдат връщани (в изходния код), 


или неочаквани. 
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Най-простият филтър е РивтаСпет Ехсерпоп!Еег, който има за цел 
да събира и обработва грешките от тип Ризта(Сйеп!кпоухипКедиезтеггог. 
Създадени са прости условия за проверка на кода на грешка, който 
Рпзгла връща. Всички тези кодове са описани в документацията на Рпзгпа 
ОВМ, като за нуждите на този проект се използват двете най-често 
срещани грешки - Р2002 (конфликт) и Р2025 (не е намерен запис - връща 


се най-често при извикването на ЯяпайтдиеОгТВгоуи. 


Топ ег 4 
051: Агдитеп зНо51) 4 


фиг. 3.1.59. - Филтър за обработване на Ризта грешки 


Следващият филтър е валидационният, той връща всички грешки, 


които с!а55-маПдатог му е върнал. 


Ехсер Топ Лег 4 


1: Ма|тда?ТопЕхсер? топ, ! : Агдитепзно51) 4 


Везропзе>(); 


фиг. 3.1.60. - Филтър за обработване на валидационни грешки 
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Главният филтър за обработване на грешки е Ехсерпоп Е ег. Той 
имплементира Ехсерпоп ЕШЖег на Мез 5, като обработва нормалните 
грешки и ги връща, или при фатални такива, връща не само отговор, но и 


запазва в лог файловете си и терминала. 


„ Ехсер опЕЛтег < 
(СЕ ); 


: ипКпоип, По: Агдитеп!вНоз+) 4 
(); 


Везропве>(); 


в 5Егъпа; 
: 51гпа; 
е: НЕТрбТа?из; 


ра 
(); 
(()) НЕТрЕхсер?ТопВоду 


: сега; 


5Ег1па; 


фиг. 3.1.61. - Филтър за обработка на всички останали грешки 


319. Операции на обяви 


В останалите точки (без последната, която е за търсене) се 
разглеждат сравнително подобни функционалности, но със съществени 
разлики. Тъй като всички контролери в проекта спазват СВЦО““ 


изглеждат и се използват по много подобен начин. Поради това 
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изходният код ще бъде съкратен и няма да включва всички части. За 
пълен изходен код може да разгледате приложения към дипломната 
работа електронен носител, в който се съдържа кода. Може също така да 
посетите С!НиБ хранилищата на проекта. 

Както всяка функционалност така и обявите, местата и други са в 
свои собствени модули с бизнес логика, контролери, типове, входни и 
изходи шаблони (дТо) и други. 

В контролерът се съдържат следните пътища и операции (фиг. 51.62.) 
- на начален път /Пзипа" са създадени операции за създаване на обява и 
взимане на много обяви (под формата на карти), на подпътя, съдържащ 
ИН (ии) на обява, /ПзипаДиша? са създадени операции за извличане на 
пълната информация на даден пост, актуализиране и изтриване. Освен 
това има още два пътя - /изипаДишаугате" и ИизппаДишщ/заме", които се 


използват съответно за оценяване и запазване на дадена обява. 


е: 115 1лабегутсе) 4 


фиг. 3.1.62. - Съкратен контролер, показвайки всички пътища 


-т- 


За създаването на обява има път за РОТ заявка, който е защитен с 
О0зебСиагаз ми АДит!Очага/, тъй като за да може да бъде създадена 
дадена обява, потребителят трябва да се е регистрирал. По 
подразбиране РОЗТ заявките връщат код 201. Използвани са декоратори 
за документация с Ореп-АР! 5ууаддег като Ар! ВеагегАшт! |), ОАр!Воду() и 
ОАрюЮккКезропзе(). Методът за създаване на обява приема тяло от тип 
Сгеате Пзппа Ото, като също взима потребителя от заявката, съответно 
анотирани с ОВойу() и ОКеа(). След което извиква методът сгеате() на 


бизнес логиката. 


фиг. 3.1.63. - Път за създаване на обява 


В бизнес логиката (фиг. 31.64.) се проверява дали категория с такъв 
ИН съществува и след това трансформира данните в друг тип обект с 
раттоСазз(), който е съвместим за качване в базата данни. След това се 
създава транзакция с Рпзгла ОВМ и се взима готовата обява, която бива 
трансформирана с рапТтопзтапсе функцията, за да бъде върната на 
потребителя. 

Транзакциите в Рпзгла ОЕМ са специални, тъй като те се създават 
чрез извикването само на един метод за създаване. Следователно 
създавайки другите таблици посредством връзките си с главната таблица 


(ИзПпа - за обява). Трансформираната информация се предава чисто на 
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функцията, докато за останалите таблици се или създават връзки с вече 


съществуващи записи, или се създават нови записи. 


фиг. 3.1.64. - Бизнес логика за създаване на обява 


Създават се връзки към вече съществуващи потребител и категория, 
създават се нови записки и връзки за всяка снимка и най-специалната 
част - таговете, ако даден таг вече съществува - се създава връзка, ако ли 


не - се създава и нов запис и нова връзка. 


фиг. 3.1.65. - Транзакция за създаване на обява 
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Извличането на обяви е специално, тъй като то е разделено по 
страници и лимити. Тук са използвани всички нормални декоратори, но 
и тези за страници, обяснени в т. 3.1.7. - ОАор/ОиегуРадтатеа() и 
ОАр езропзеРадиатеа|), която приема типа, който се връща - тип за 
картичка на обява. Методът приема ОРадтаге|) - страница и лимит, и 


ООчегу| - незадължителен параметър за филтриране по категории. 


фиг. 3.1.66. - Път за извличане на много обяви по страници с лимит 


В бизнес логиката за намиране първоначално се взимат ИН на 
категорията и нейните подкатегории, ако е подаден незадължителния 
параметър за филтриране. Следователно, в зависимост дали е избрана 


категория, или не, се определят условията на заявка. 


фиг. 3.1.67. - Първа част от бизнес логиката за извличане на много обяви 
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След това бизнес логиката продължава с извличане на броя на 
обяви, отговарящи на условията (Тота! Сочп!?) и след това извлича самите 
обяви, като използва зЖр и ТаКке на Рпзгпа ОНМ, за да се имплементира 
извличане по страници. 

След това се образува резултат, който взима едната снимка (с огдег 
равно на 1) от масива със снимки, като я слага в полето Чигпрпа!. След 
това този резултат се трансформира с раптТопхзтапсе() и се връщат 


метаданни като номер на страница, лимит и общ брой резултати. 


фиг. 3.1.68. - Остатък от бизнес логиката за извличане на много обяви 


В пътя за извличане на дадена обява се използва Мез 5 СиагЯ за 
управление на достъп чрез права за гледане без употребата на 7МУТ Ашт 
Сиага. Използвани са обикновените декоратори, както и специалните за 


управление на права - ОАсиоп() и Фезоигсе(), които в този случай 
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приемат меу” (за гледане) и 15Ппа!" (за обява). Единственият Сиатга, който 


се използва е този за управление на права - Регт!55/опзОшага. 


сет ("зиша") 
Ас?1оп( "м1ем" ) 
Кезоигсе( "1151 1пд") 
Узебиагйв ( Регт155Топзбиага) 
АртВеагегАиш?й( ) 
АртРагат( 4 

2 Мицидве 

за 5втла: 
+) 
АртОкКезропзе( 4 

сет а 1151119 Бу ишто 

: Кезропзе 151 1пд0то, 
+) 
азупс Е1пдОпе(вРагат( "иш14") ии: зЪгтпа): Рготузе<Кезропзе 151 1пд0Ото> 4 

1115. 115 1пдбегм1се. тпдОпе(иита); 

+ 


фиг. 3.1.69. - Път за извличане на подробна информация за една обява 


Бизнес логиката е сравнително проста, като единствено се извиква 
допълнителна помощна функция, за извличане на оценката на 


потребителя, като след това този резултат се трансформира. 


азупс Е1п9Опе(ии19: зЪгтпа): Рготм1зе<Кевропвей15811п90+о> (4 
115+1па ама! Е Е115.рг1вша.115+1па.#1п90п1ачедгтнгом (4 
инеге: 4 

чч1а, 

дететед а: пи!1, 

изег: 4 
дететед а: пи11, 

)», 


зетесЕ: 11511пазе1ес+, 


+); 


сопз5Е ивегнантпа ама 6 115. . (1ъвЪ1па. 


гекцигп р!атпТоТпзъапсе(Везропзей1 5 +1па0+о, 4 
а. Шавбатет 
: ивегка:1па, 
)); 


фиг. 31.70. - Бизнес логика за извличане на подробна информация за обява 


Оценяването и запазването на обява също са защитени с 
Регговзопв Сиага, тъй като тези операции могат да бъдат изпълнени само 


от тези, които имат права да видят дадена публикация. Пътищата не са 
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показани на фигура, поради тяхната прилика с останалите. В бизнес 
логиката за оценяване се използва една специална функция на Рпизгпа 
ОБМ - ирзе |) - позната като ирдайе ог пзет (ако даден запис съществува 
- да бъде актуализиран, ако ли не - да бъде създаден). 

Тъй като един потребител може да има само една оценка за дадена 
публикация, се проверява дали тя вече съществува, за да се види дали да 


се създаде, или актуализира, като след това се връща новата оценка. 


фиг. 3.1.71. - Бизнес логика за оценяване на обява 
Проблем идва в метода за запазване на обява, тъй като предишни 


стойности не могат да бъдат прочитани чрез функцията ирзег:)). Затова 


първо се проверява за съществуващ запис - ако такъв съществува, то той 
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инвертира полето дали е изтрит записът. Ако не съществува се създава 


нов запис за тази връзка. 


азупс заме(иш1й: 5Ъгтпдо, изегш 14: 5Ъгтпа): Рготузе<КезропзебамедОто> 4 
ех15Т1пабаме ама 1115.ргъзта.изегбамед! 151 1паз. ТпдШптаче( 4 
мпеге: 4 
изег ишт4 11511пд чия: 4 
изег цитй: изегфшта, 
1151 19 пи: чита, 


1 (еху5? 1пабаме) 4 
соп51 замед ама 1115. 


за 


: изегушта, 
пола 


: ех15 1 пабаме. пи 1. : пем Оате(), 


: тгие, 


гетигп 4 
5амей. 
Те 
+ 


ама 115. 


а! 
Зла! 


: изегушта, 


гетигп 4 
: тгие, 


и 
и 


фиг. 3.1.72. - Бизнес логика за запазване на обява 


При актуализирането и изтриването на обяви се използват както 


ЗУУТ Ач! Счага, така и Регповятопв Сиага за права за достъп. Като при тези 
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два маршрута са нагласени с анотация (ОАсиоп( таподе") за действие на 
модифициране на дадена обява. 


Ратсп(“:иц 
Кезоигсе(! 
АсТтоп( "ма 
Изебиагдс( Ум ЕДитиСсиага, Регтз5Топзбиага ) 
Ар ВеагегАц? 1 () 
АртРагат( 4 
# Ишота 
: 5Еглд, 
|) 
АртВоду( 4 
: Прдате 151 1лддто , 
>) 
АрТОКкКезропзе( 4 
: "Прдате а 1151 1пд Бу ци", 
: Кезропзе 151 1пд0то, 
: 200, 


т) 

азупс ирдате( 
Рагат("ич9") ид: сЪг1па, 
Кед() гед: Кедие5б ит И5<ег, 


Воду() ирдате 1111900: ЦПрдате 151 1пд0то , 
): Рготмузе<Кезропзе 151 1пд010> + 
1115. 115 1пдбегу1се. ирдате (ци, гед.изег.ици14, ирдаТе 151 1пд0о); 
? 


ОПе1ете(!: 
Кезоигсе 
АсТТоп( " мапас 
Изебиагй (Зм ЕАитибиага, Регтуззтопзбиага) 
Ар ВеагегАш?й() 
АртРагат( 4 
уаишеаве 
Я Заре 
?) 
АртОККезропзе( 4 
в. Норещецие пер Цизлешие Ноу (пе 
: 204, 


азупс гетоме(вРагат( "иит9") ии: 5Ъгтпа) 4 
гефигп Аб. А (чита); 


+ 


фиг. 31.73. - Маршрути за актуализиране и изтриване на обява 


При изтриването на обява, се извършва т.нар. „меко изтриване“, 
където самият запис не се заличава от базата данни, а му се променят две 


полета - статус на изтрит, и изтрит на - текущо време. 


азупс гетоме(шитй: 51г1па) 4 
гетигп ЕА. 


зо 
а 


1 ЗВЕШЕШЕВЬЯ 
: пем Оате(), 


фиг. 31.74. - Бизнес логика за изтриване на обява 
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Методът за актуализиране е почти еднакъв с този на създаване, с 
единствената разлика, че се извиква функцията ирдате от Риза ОНМ. 


Методът за създаване може да бъде разгледан на фиг. 3.1.64. и 3.1.65. 
3110. Операции на места 

Операциите, които могат да се извършват на места много 
наподобяват тези, разгледани вт. 51.9. за обяви, поради което в тази точка 
ще бъдат разгледани по-специфичните случаи и заявки, които се 


изпълняват за места, като нормалните СВО функционалности няма да 


бъдат разгледани. 


: Расебегу1се) <> 


: 5ъгта) 4 


слсвелпери Ори 


фиг. 3.1.75. - Контролер за места 


-120- 


В контролера се съдържат нормалните СЕПО операции - създаване, 
взимане (на една или повече обяви), актуализирането на местата, както и 
тяхното изтриване. Специални операции, които може да се извършват 
върху местата са: запазване и отбелязване на присъственост както и 
заявка за взимане на всички, които са били на това място. 

Главна промяна, която трябва да бъде отбелязана е, че СЕВЦО 
операциите се изпълняват за места, а не за обяви, както е описано вт. 3..9. 
и съществуват много разлики в данните, които се получават и изпращат. 
Те могат да бъдат разгледани във файловата структура на модула за места. 
Една от забележките за СВЦО функционалността е, че при извличането на 
много места има два типа, данни, които могат да бъдат върнати - 


информация за картички за места или информация за пинове на карта. 


фиг. 3.1.76. - Връщане на различен тип данни за много места спрямо типа на 


извличане - за корта или за картички 


Други модификации, които са направени спрямо обикновения 
СВО, за извличането и изчисляването на средноаритметична оценка за 
всяко място, което се извлича като картичка. Където с метода дгочрву() на 
Риза ОНМ се групират оценките на местата по идентификационен 


номер, като след това за всяко едно от тях се изчислява средна оценка от 


ЗОП 


501 АМС функцията. След това, заедно с главните снимки за изглед 
(тлигорпа!), се поставят оценките за всяко едно място в неговия обект и 


се връщат. 


соп5 1 га? 1п95 ама 1115. 


Вар 


: руасез. ((рТасе) рГасе. 


соп5 1 га! 1пазМар пем Мар( 
гат1пдз. ((г) Ще 
уа 


соп5 1 гези| + рТасез. ((рТасе) 4 
соп51 амегадеКа? па га 1 позМар 


: (р|асе. 
соп5+ | ЕпитБпат | р(асе. 5 


гетигп 4 
...рТасе, 
: гопаванло(змегавеваналаии 
е 
гетигп 4 


: рратлТоТпзТапсе(КезропзеСагаРТасейто, гезш +), 
...радтпаттоп, 


фиг. 31.77. - Извличане и изчисляване на средна оценка 


за всяка картичка на място 


Подобно на извличането на една обява, така и при извличането на 
едно място, то се прилага заедно с него потребителя, създал даденото 
съдържание. Освен това към мястото се добавят както собственик, ако 
има такъв, така и последните 3 ревюта, последните 5 посетители. Което 
означава, че за всички тези компоненти трябва да се извлече и изчисли 
тяхната оценка (за потребителите), както и средната оценка на дадено 
място. Средната оценка на мястото се изчислява с агрегатния метод на 


Рпзгла ОВМ за дадено място по ИН, докато при потребителите - създател, 
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собственик и последните 35 посетители, се извиква метод от бизнес 
логиката на потребителите за изчисляване на тяхната 
средноаритметична оценка - де Шзегвайтоа |), ато след това те се добавят 


към отговора на заявката. 


соп5 амегадеКа?1па ама 1015. 
В 
: ша, 


соп5? сгеаТтогКат1па ама 1115. 
рТасе. 

ре 

соп5 омпегкаттпа ама + 1115. Е (рТасе. 


соп5 Е м151ЕогзКа? 1 пазРготтзе рТасе. : (азупс (мб ог) 
соп5Т пеумМ151тог рфатпТоТпзТапсе(М15 1 огО То, м15 ог); 
гетигп ЕП1Ъз. 5 (пеуМ1в1Тог. я ЛЕ 
Те 
соп5 1 мб огКа?тпаз < ама Ргот1зе. (мЪъв1огвКа? 1пазРгот15е); 


гетигп ра пТоСТаз5 (КезропзеР(асейто, 4 


...рТасе, 
и 


пад 
...рТасе. 2 
: гошпдКаттпа( сгеатогКаттпа), 


за 
...рТасе. 
: гоипдКа?1по(омпегКа? 1па), 


: рбасе. Е ((мъбтог, 1) (4 
зелено 
: гоипдКа?1па(м151ТогКаттпаз | 11), 
Паууе 
: гоипдКа?Тпа ( амегадеКкаттпа. 


фиг. 31.78. - Извличане и изчисляване на средни оценки за място, създател, 


собственик и посетители на място 


За метода на отбелязване на даден потребител за неговото 
присъствие, се взима ИН на потребител от )МУТ токен за авторизация, като 
се взима и ИН на дадено място от ОН! параметър. Методът за отбелязване 
наподобява на смесица между метода за запазване на място / обява и 


оценяване на обява. Първоначално се проверява дали вече съществува 
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такава много-към-много връзка, като ако съществува, то полето за меко 
изтриване на връзката се инвертира, а ако не съществува, то тя се създава. 


За тази цел се използва функцията на Рпзгла ОНМ - ирзе 6). 


азупс Ппеге(иитй: зЪгтпд, изегШи9: зЪгтлд): Рготузе<КезропзеНегейто> 4 
ех 51 1паНеге < ама Е115.ргзта.р|асеут51тог.  1лдШптаче( 4 
мпеге: 4 
рбасейита изегбита: 4 
ртасейит: иита, 
изегуита, 
+, 
>, 
Та 


соп5Т гез ама 1115. 
. г 
е и: 


: цита, 


: изегшта, 


: еху5 1паНеге?. пи : пем ОаТе(), 


гетигп 4 


гез. 
Та 


; 


фиг. 3.1.79. - Отбелязване на даден обект, че е посетен от потребителя 


Другият метод, който е уникален за контролера и бизнес логиката на 
местата, е този за извличане на всички потребители, които са се 
отбелязали като „посетили“ дадено място. Методът също е направен за 
връщане на данни, разделени на страници и с лимит на бройка. След 


което се извличат всички потребители, които са били на дадено място по 
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ИН, които не са изтрити, за дадена страница с даден лимит, като след това 


се изчисляват средните оценки за всеки потребител 


форматиран резултат. 


азупс деТНеге( 
радтпа?Топ: Радтпаттоп, 
пи: зЪгта, 
): Рготусе<Радт пат топКези 1101 о<КезропзеСагдИзегдто>> 4 
Тота Соип? ама +115.ргъзта.р|асеМ1з1тог.сошп? (4 
мпеге: 4 
р|асейит: иита, 
де|етед ат: пиЦ, 
+, 


и): 


соп5+ Пеге ама 1115. 


: рад па?топ. радтпаттоп. радтпаттоп. 
: радтпа! Топ. 


гетигп 4 
: руацлТоТпзТапсе(КезропзеСагайШзег0то, гези 1), 
...радтпаттоп, 


и се връща 


фиг. 3.1.80. - Извличане на потребителите, посещавали дадено място 


Останалите заявки може да бъдат разгледани на електронния 


носител или в СИНир хранилището на проекта, като те наподобяват на 


тези от т. 5.1.9. 


3111. Операции на коментари и ревюта 


Подобно на услугите и контролерите за обяви и места, тези за 


коментари и ревюта си наподобяват, като ще бъде разгледана само 


първата услуга и контролер - тази за коментари. 
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В контролера за коментари / ревюта се съдържат само обикновени 
СВОО операции - за извличане на един или много коментари / ревюта 
(спрямо дадена обява / място), за публикуване на коментар / ревю на 
дадена обява / място, за актуализиране и изтриване на даден коментар / 


МЯСТО. 


Соп го 1ег!( 


ехрог! с1а55 Соттеп! Соп го Цег 4 
(ргъмате геадоп у соттеп 5егутсе: Соттеп!5егу1се) 4? 


сет(":5иБ | 


азупс 


Ра сй(! :5и 


азупс 


Оетете( 


азупс 


фиг. 3.1.81. - Контролер за коментари 


Както е обяснено в т. 51.9. на всеки път са сложени различни 
декоратори както за документация със бууаддег / Ореп-АР!, така и за 
различни защити - примерно с (дйзеСиагав(). Обаче за създаване на 
коментар се добавя и защита, която проверява дали даден пост, може да 
бъде разглеждан от потребителя, преди да му се даде възможност да 
коментира. Това може да бъде забелязано при всяка добавяща или 
модифицираща операция в контролерите за коментари и ревюта. Те са 


имплементирани с Регт!55/опзОшцагй и с анотациите: (ОАсиоп() и 
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ОкКезоигсе|). Пътят за създаване на коментар приема от ОН! параметрите 
- ИН на обява, а от тялото на заявката - съдържанието на дадения 


коментар. Потребителският ИН се извлича от Ту Аш Сиага. 


Ро51() 


Асттоп(! ) 
Кезоигсе( "1151 1пд") 
Изебиагдв (Зм + Аитбиага, Регт1551опзбиага) 
Ар ВеагегАштй() 
Арт Воду( 4 

: СгеатеСоттеп?0то , 


|) 
Ар Кезропзе( 4 
зи 20П: 
: КВезсропзеСоттеп?дто , 

|) 
асупс сгеате( 

Кеа() гед: КедиезТ И 1 Е НО5зег, 

Воду() сгеатеСоттеп?0то: СгеатеСоттеп? то, 

Рагат(! 9") шшд: 5Ъг па, 
): Ргот|зе<КезропзеСоттеп!0то> 4 

1115. соттепт5бегу1се. сгеате( гед. изег.ии19, ии19, сгеатеСоттеп? то); 


, 


фиг. 3.1.82. - Път за създаване на коментар 


За създаване на коментара се използва функцията сгеате() в Рпзгпа 
ОЕМ, като се подава съдържанието и се правят връзки с обявата и 


потребителя, създал дадения коментар. След това се връща резултат. 


азупс сгеате( 
изегита: зЪгТпа, 
ТъзттпдШита: зЪгтпа, 
сгеатеСоттеп? Ото: СгеатеСоттеп?0то, 
): Рготзе<КезропзеСоттеп?!0то> 4 
сгеаТтедСоттепт аматт 1115.ргЪзта. 115 + 1пдСоттеп?. сгеате( 4 
дата: 4 
соптеп?: сгеатеСоттептОто. соптепт, 
изег: 4 
соппест: 4 
цит: ивегйша, 
Те 
е 
1ъз па: 4 
соппест: 4 
пита: Тъзттпайита, 
и, 
Ва 
зетест: Соттепт5е|ест, 
>): 


гетигп рГ а пТоСТаз5(КезропзеСоттеп! Ото, сгеатедСоттепт); 
+ 


фиг. 8.1.85. - Бизнес логика за създаване на коментар 


1127 - 


За извличането на всички коментари на дадена обява, потребителят 
трябва да има достъп до преглеждане на обявата. Имплементирана е по 
същия начин както при създаването на коментар. Пътят връща всички 


коментари, разделени по страници, спрямо дадения лимит (Радтпайоп). 


се!) 

АсТТоп( "мТем") 

Кезоигсе( "1151 1па") 
Изебиагв ( Регт15510пзбиага) 
Ар ВеагегАштй() 
АртбиегуРадтпатей( ) 


Арт ОККезропзеРадтпатей( КезропзеСоттеп?0то ) 
абупс ТЪпдАЦ ( 
Рагат(! 9) чий: 51Ъгълд, 
Радтпате() радтпа? топ: Радтпа Топ, 
): Рготузе<Радтпа топКези 110 0<КезропзеСоттеп? 01 о>> 4 
1115. соттептбегу1се. пдА 1 (иш9, рад па?топ); 
+ 


фиг. 31.84. - Път за извличане на всички коментари на дадена обява 


Методът за извличане на всички коментари за дадена обява следва 


принципа на всички рад патеа!““ отговори. 


азупс ТъпдАЦ( 
пита: вЪгтла, 
радтпа?топ: Радтпа?топ, 
): Рготузе<Радтпа! топКкези1 10 0<КезропзеСоттеп! + о>> + 
мйегеСТаивзе 5 4 
дететед а: пи, 
5татиз: 5Татиз.РОВЕТС, 
11511ло: 4 
чита, 
Ир 
ра 


соп5 Тота  Соипт ама Е 1115. 
: ипегеСТаизе, 
а 


соп5Е соттеп 5 ама 1115. 
: Соттептбетест, 
: ипегеСТацзе, 


са 
за 


: радтпа? Топ. радтпаТтоп. радтпа? Топ. 
: радтпа Топ. 


ПД 


гетигп + 
: ра илТоТпзТапсе(КезропзеСоттеп? То, соттеп 5), 
...радтпаттоп, 


фиг. 3.1.85. - Бизнес логика за извличане на всички коментари по страница 
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Пътят за извличане на даден коментар се защитава с достъпност до 
самия коментар - с (ОРезоигсе(соттеп!). При възможност за 


извличането на коментара, се връща неговото съдържание. 


сет (|! :5и ита") 

Ас?топ(! ) 

Везоигсе(! 1 ) 
Изебиагв ( Регтъ551опзбиага ) 
АртВеагегАиштй( ) 

Ар1Рагат( 4 


: Тгие, 


+) 
Арт Кезропзе( 4 
: 200, 
: КесропзеСоттеп?0то , 
+) 
азупс Т1пдОпе(вРагат( "5иБ ии14") ид: 5Ег1па): 
Ргот1зе<КезропзеСоттеп?0то> 4 
1115 .соттептбегу1се. 1 пдОпе(иита); 
+ 


фиг. 3.1.86. - Път за извличане на даден коментар 


Методът за извличане на даден коментар по неговия ИН е отново 
прост СВПО метод, който е разглеждан в т. 31.9., където се избира 


коментар, който не е изтрит и му пасва идентификационния номер. 


азсупс Р1пдОпе(иитЯ: з5Ъгтпа): Рготузе<КезропзеСоттеп?0то> 4 
соттеп амат+ 1115 .ргъзта. 115 1паСоттеп+. пдШпташегТнгоу( 4 
мпеге: 4 
читд, 
статив: 5Татиз.РИВЕТС, 
де|етед ат: пи, 
А 
+); 


гетигп ра пТоСТазз ( КезропзеСоттепт Ото, соттепт); 


Д 
г 


фиг. 3.1.87. - Бизнес логика за извличане на даден коментар 


В пътя за актуализиране на даден коментар се приемат както ИН на 
дадена обява, така и ИН на дадения коментар, който ще бъде 
актуализиран. Пътят е защитен както с ми Ди Сиага, тъй като потребител 


задължително трябва да е в профил, така и с Регпо!55/опзОшага, който се 
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използва за извършване на проверка дали даденият потребител има 
права за модифициране на дадения коментар - неговото съдържание и 


статус (дали е публичен). 


Ратсп(!: вир пита") 

Ас?Топ( "тападе") 

Кезоигсе( пепт") 
Изебиагдв ( Зм1АитПбиага, Регтм1з51опзбиага ) 
Ар ВеагегАш?!( ) 

АртРагат( 4 


: 1гие, 


|) 
АртВоду( 4 
: ПрдатеСоттептото , 
|) 
Арт Кезропзе( 4 
: 200, 
: КезсропзеСоттептодто , 
|) 
азупс ирдате( 
Рагат( "5и! Пд") ши: зЕгъпа, 
Воду() ирдатеСоттепт то: ПрдаТтеСоттеп?то, 
): Рготузе<КезропзеСоттеп?!0то> 4 
1115. соттеп 5егутсе. ирдате(ии19, ирдаТеСоттеп? то); 
Н 


фиг. 3.1.88. - Път за актуализиране на определен коментар 


В бизнес логиката може да се актуализират съдържанието и статуса 
(дали е публичен) на коментара, чийто идентификационен номер 
съвпада с подадения. След успешно изпълнение се връща нов отговор 


под формата на извлечен коментар. 


азупс ирдате(ии1й: з51г1пд, ирдатеСоттеп! Ото: ЦрдатеСоттеп?0то) 4 
соп5 + ирдатедСоттепт - ама 1115. я : (4 
СиИр 


5 


: ирдатеСоттеп?0то. 


: ирдатеСоттеп?0то. ипде?тпед, 


: Соттеп 5бетест, 
БЕ 


гетигп ра пТоСТаз5 (КезропзеСоттеп Ото, ирдатедСоттепт); 


+ 


фиг. 3.1.89. - Бизнес логика за актуализиране на определен коментар 
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Пътят за изтриване на даден коментар е също защитен както с УМУТ 
токен, така и сусловия за права на модифициране на коментар. В бизнес 
логиката, която се извиква от контролера, се извършва т.нар. „меко“ 
изтриване, където се попълва с текущата дата и час полето „дейетей а!" в 


таблицата за коментари. 


фиг. 3.1.90. - Път за изтриване на определен коментар 


3112. Операции на потребители 


Контролерът за потребители е един от най-големите и пъстри 
контролери в този приложно-програмен интерфейс. Логически може да 
се раздели на две части - заявки за личен (регистриран) профил, както и 
за публичен такъв, като по него се работи с подаване на потребителско 
име. 

Пътищата, които са за личен профил са защитени с 
О0зебиагаз ми Аш! Оиага). Като с този Мез0Ш5 Сиага се извлича и 
идентификационния номер на потребителя, на когото съответно се 
извършва дадената заяква. Пътищата са следните: 

- Дизе/те - заявка за извличане на данни за текущо 


регистрирания потребител 
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- Диве/те/15ипа - заявка за извличане на обявите, публикувани 
от текущо регистрирания потребител 

- /изе/те/расе - заявка за извличане на местата, публикувани 
от текущо регистрирания потребител 

- Дизе/те/бамеа/випа - заявка за извличане на запазените 
обяви от текущо регистрирания потребител 

- Дизе/те/бамеа/расе - заявка за извличане на запазените 


места от текущо регистрирания потребител 


фиг. 3.1.91. - Част от контролера за потребител, с показани права на достъп - 


пътища за личен профил 


За извличането на профила на регистрирания потребител се 
изпълнява проста заявка с Рпзпа ОВМ - АппдЦпачеОг?игоуу(), където се 


извлича само по идентификационния номер на потребителя от УМУТ 
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токена за достъп. При несъществуващ такъв потребител - връща се 
грешка 404. При успешно извличане се изчислява и оценка с помощния 


метод де Шзеграйпа)). 


асупс дет ШзегРго? Ле(иитй: 5Ъгтпд): Ргот|зе<КезропзеРго? 11ейто> 4 
изег з ама! 1Н15.ргузта.изег. ъпдИптачейгТнгом( 4 
мпеге: 4 
цитад, 


Де 


соп5 Е изегка! 1па < ама 1115. 


гетигп ртатпТоТпзтапсе(КезропзеРго? Лейто, 4 
...ивег, 
: изегКа?тпа, 
В 


фиг. 31.92. - Бизнес логика за извличане на текущо регистрирания 


потребител 


В помощният метод за извличане на средноаритметичната оценка 
на потребител се използва функцията на Рпзгла ОВМ за групиране на 
данните по определен критерий, като след това се изчислява 
средноаритметичната оценка на този потребител спрямо неговия ИН и 


оценените потребители. 


азупс дет ИзегКа?Тпа(ии19: 5Ъгтпа | ипде? 1 пед): Рготузе<питрег> 4 
(Г ич19) гетигп 0; 


соп5 + изегКа? па ама 1А15.ргзта.изегбка? па. дгочрВу(< 
Бу: | 9 шита 
ама: 4 
га?! 1 па: Тгие, 


и 


мпеге: 4 
изег гатед иид: ичъд, 


| )3 
сопзо1е. (иве 195", изегКа?тпа); 


гетигп изегка?тпа! 0) гоипяКатпа ( изегКкаттпа | 01. 


фиг. 31.95. - Помощен метод за извличане на средноаритметичната оценка на 


даден потребител (по идентификационния му номер) 
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Пътищата за извличане на обяви и места, създадени от 
регистрирания потребител, използват вече направените методи от 
бизнес логиката за услугите на места и обяви тип „ПпЯА!", които приемат 
незадължителен параметър - потребителско име. От Ум Аи Оцага се 
извлича потребителското име на клиента, което се подава на метода, 


който извлича или обявите, или местата. 


Пътищата, които се > използват за операции на > публични 
потребителски профили (един или много), са следните: 

- Дзе/рготе - извличане на всички потребителски картички 
(само публична профилна информация) по страница с лимит 

- Две/изетате| - извличане на публичен потребителски 
профил по подадено потребителско име като ОН! параметър 

- Диве/изетатевипа - извличане на всички публични обяви 
(по страници), създадени от публичен потребителски профил, 
по подадено потребителско име като ОН! параметър 

- Дизе/изетате/Моасе - извличане на всички публични места 
(по страници), създадени от публичен потребителски профил, 
по подадено потребителско име като ОН! параметър 

- /- извличане на цялата потребителска информация - публична 
и частна. Този път е защитен за използване само от 
потребители с > администраторска роля. Използван е 
специалния (сизтога) декоратор ОЕВоез(АПОМ!М), в който е 
подадена само администраторската роля, освен това е сложен 
и О0зебиагаз (му Аш! Очата, РоебСиага/ за авторизация. 


- РО5П /изе/гатейизетате) - защитен път за създаване на нова 


оценка или актуализиране на такава за друг потребител 
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- ЮЕП /изе/гагейизетате! - защитен път за извличане на 


оценка, направена от потребител (взет от Ум Аи НОшага), за 


подаден от ОН! параметър потребител (по потребителско име) 


Сет ( "рго? Це") 


азсупс детРго? ез ( 


сет(" : изегпате") 


азупс дет Рго? Пе 


сет(" : изегпате/ 1151 1па") 


азупс дет Рго? Пе 1511пдз ( 


сет(! : изегп се") 

азупс дет Рго? 1еРТасез ( 

се|) 

Изебиагв (Зм + Аитпбиага, КоТебиага) 
Ко1ез ( "АОМТМ" ) 
азупс де! Шзегв ( 

Ро5+( Ее/ : изегпате") 

Изебиагдз (ЗмАитпбиага ) 


азупс га?е ( ри 


сет( ДНИ ате") 


Изебиагдв ( Зм + Аитбиага ) 


азупс детКате ( 


фиг. 31.95. - Част от контролера за потребител, с показани права на достъп - 


пътища за личен профил 


За извличане на публичен потребителски профил се използва 
помощната функция за намиране на потребител по потребителско име, 
след което се проверява дали той е празен, ако да - такъв потребител не 


съществува и се връща грешка. При успешно извличане на потребител се 
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изчислява неговата средноаритметична оценка с помощния метод - 
де: Шзегвайпоа!), след което се връща резултат. 


азупс детРиБ1 1 сРго? е изегпате: 51 г 1па): Рготзе<КезропзеРи 1 1сРго? Пейто> 4 


изег ама 1115. 1 пдВуШзегпате( изегпате); 


Е (1 ивег) 4 
Тлгом пем Мо РошпдЕхсер?топ( "ПЗЕК МО 


+ 
соп5 + изегКа?т1па < ама 1 1115. (изег. 


гетигп р|атпТоСТаз5 (КезропзеРи | 1сРго?11ейто, 4 
...ивег, 
: изегКа?Тпа, 
Пе 


фиг. 3.1.96. - Бизнес логика за извличане на публичен профил по 


потребителско име 


За извличането на много потребителски картички по страници се 
изпълнява обичайната радпатед процедура за извличане чрез Рпзгла 
ОЕМ и ПпаМапу(), но в този случай за потребители. След това се 


изчислява оценката на всеки потребител и се връща резултат. 


асупс дет Ри 1сРго?Пез( 
радтпат Топ: Рад па топ, 
): Рготузе<Радтпа  топКези1+0То<КезропзеРиБ1 1 сРго? Тейто 4 
мпегеСТаиве - 4 
дететед ат: пшШ1, 
# 


сопзт Тота Соцп+ ама е Ев 
: мпегеСТацзе, 
|); 


соп5 Е изегд ама Е 1115. 
: мпегеСТацзе, 


: радла Топ. рад! латтоп. рад па? топ. 
: рада? Топ. 


гетигп 4 
: рбащлТоГпв апсе(КезропзеРир 1 сРго еко, гез 3), 
...радтла топ, 


фиг. 3.1.97. - Бизнес логика за извличане на потребителски картички 
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Всички останали функции, подобно на личния профил, използват 
вече създадените методи за извличане на всички постове (обяви или 
места), като им се подава аргумент - потребителско име и публична 
видимост. 

Методите за оценяване са подобни и почти еднакви с тези за 
оценяване на пост (обява или място) от потребител. Но с две 
допълнителни проверки - проверка за съществуващ потребител, който 
подлежи на оценка. Както и проверка дали потребителят се опитва да 


оцени себе си, което не е позволено. 


фиг. 3.1.98. - Допълнителни проверки върху метод за оценяване 


3113. Търсене в уеб приложението 


Търсенето в уеб приложението е разделено на два вида - едно 
глобално и друго - по категория (обява, място или потребител). Идеята на 
глобалното търсене е да покаже малък на брой резултати от всяка 
категория на потребителя, за да може след това той да прецени къде да 
търси по-подробно - т.е. да избере търсене по категория. 

В контролера за търсене съществува само един път - този за търсене, 
който се изпълнява с СЕТ заяква. При него е задължително да бъде 
обособена търсещата дума или думи като част от ОН! на заявката. Като 
опциите за страница и лимит (Радпайпоп) се използват само при 


подадена категория. В този път се избира и коя бизнес логика трябва да 
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поеме изпълнението на търсенето, спрямо това коя категория е 
подадена, или дали въобще е подадена. 


Фе 
Соп го 1ег( " зеагсп") 


ехрог! с1аз5 5еагспСоп го ег + 
(ргъмате геадоп!у зеагспбегутсе: беагсПпбегу1се) <> 


сет () 


азупс ( 
иегу ( "сеагсП") зеагсп: 51г1пд, 
Радтпате() рад ла! Топ: Рад па! Топ, 
Циегу( "сатедогу") сатедогу?: "РгееТтапсега 
): Ргот1ве 


Радтпа ТопКези1 + 0То 
Кезропзебпог! | 1511 пд0о КезропзеСагдРТасейто КезропзеСагайзегОто 


беагспА 1 0То 
зеагсп беагсй. 


51 сп (сатедогу) 4 
сазе "Егее|апсе 5 
гетигп #115. с (5еагсп, радтла! Топ); 


(зеагсп, радтпа? топ); 


(зеагсп, радтпа! Топ); 
деташ +: 


гетигп 115. с (зеагсп); 


фиг. 3.1.99. - Контролер за търсене в уеб приложението 


При неподаване на категория, се извиква метода за глобално 
търсене в уеб приложението. В него се извикват по-малките методи за 
търсене по-категория, с предварително зададени лимити и номер на 
страница. След тяхното изпълнение се връщат лимитирани резултати от 


всяка категория. 


азупс зеагсПАЦ  (аиегу: 5Егла): Рготузе<беагспА 1 0То> 4 
ПъзЪтдв, рГасез, изегв | ама + Ргот1зе. (1 
1П1в. (дчегу, + 
В 
а 185 


(дчегу, 4 


(дчегу, 4 


е 


гетигп 4 


фиг. 3.1.100. - Бизнес логика за глобално търсене 
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За търсене, на която и да е категория, се използва нормалната 
функция за извличане на много данни на Рпзгта ОКМ - ЯпаМапу), но с 
една съществена разлика - всички елементи се сортират по релевантност 
(най-подходящ резултат) с вградената функция на Розтагеб ОГ или Му5ОГ 
за Ри! Тех 5еагсп!““ като се поставя начина на сортиране, полетата, които 
да се използват за сравнение и с какъв текст да се сравнява (този, 
подаден от потребителя). 

За търсенето на обяви се прилага познатият метод за рад патед 
извличане с пропускане на М елементи и взимане на М елементи. Както е 
описано в горния параграф, във функцията за извличане се използва 
сортиране по релевантност, като зададените полета за търсене са: 
заглавието и описанието на обявите. След тяхното извличане от базата 
данни, се оправя главната снимка и се връща готов резултат на 


потребителя. 


фиг. 3.1.101. - Метод за търсене на обяви 
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На подобен принцип са изработени и останалите методи за търсене 


на съдържание, като търсенето на място отново е радпатей. Резултатите 


се сортират по релевантност спрямо полетата за наименование и 


описание на местата. Освен това се оправят както главната снимка, която 


се използва за картичката (ШлигпобБпа!), така и оценката на мястото. 


азупс зеагс!РТасез ( 


| 


дчегу: 51г1па, 
радтпа? топ: Рад паттоп, 
Ргот5е<Рад1па  топКези1 101 о<КезропзеСагаРТасейто 
упегеСТаизе + 4 
дететед а: пи, 
5татиз: 5Татиз.РИВСТС, 
сгеатог: 4 
дететед ат: пиЦ 4, 
Г 


ие 


соп51 Тота Соцпт ама 1115. 
: ипегеСТаизе, 
Не 


сопз+ ТошпаРТасез5 ама 1115. 
: ипегеСТаизе, 
: СагдРТасебетест, 


за 


: радтпаттоп. радтпа? топ. радтпаттоп. 
: радтпа? топ. 


гетигп 4 
: ра лТоТпзтапсе(КезропзеСагдРТасейто, гезш +), 
..„радтпаттоп, 


фиг. 3.1.102. - Метод за търсене на места 
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В метода за потребители се сортира по релевантност 


потребителското име, името на потребителя и неговото описание. 


азупс зеагс!Шзего ( 
диегу: 5ЕгТпа, 
радтпат топ: Радтпаттоп, 
): Рготузе<Радт па? топКези1 101 о0<КезропзеСагдИзегОто 4 
Тота Соцпт ама + 1115 .ргЪзта.изег. сошп (4 
упеге: 4 
дететед ат: пи, 
», 
В 


соп5 Е ТошпдПзегд ама 1115. 
за 
запшще 


: радтла?топ. рад1па? топ. радтпаттоп. 
: радтпа? топ. 


е) 


гетигп 4 
: рбуатлТоГпзТапсе(КезропзеСагаШзегОто, ТошпдИ5зегв), 
...радтпаттоп, 


ШЕ 
+ 


фиг. 3.1.103. - Метод за търсене на потребители 
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3114. Обобщение на всички контролери 


ивег А 

| ве | /ар3/изег/те гра 
| ве | /ар/изег/те/1153па ву 
| ве | Гар? /изег/пе/р(асе в“ 
| ве | Гар1/изег/пе/зауей/11511па в 
| ве | Гара /изег/те/замей/р(асе в“ 


| ве | Гар? /ивег/рго Ле Ка 
| ве | /ар/изег/(изегпате) Ха 


| ве | /ар3/изег/<изегпате)/11511пд м 
| ве | /ар/изег/(изегпате)/р(асе м 
| ве | Гарт /изег в. 
Гар1/изег/гате/(изегпате) в 
| ве | Гара/изег/гате/ (изегпате) в 
адтт г 
Пасеса Гарт/изег а - | 
/ар1/ сатедогу/ (Туре) в“ 
/ар3/ сатедогу/<Туре)/ии14 в“ 
Гарз./ сатедогу/<туре)/(шит4)- ае“ 
ДЗИ /ара/зегмасе е - 
/ара/зегудсе/(шиз4 в“ 
Гар/зегу1се/<ши14) ам 
ашт 2 
Гара/аитп/Лодап м 
Гарз/аитп/уатддате/ассошп? м 
/ара/аиштп/малдате/регвопат м 
Гарз/аитп/з3апир 24 
/ар3./аитп/Лодоит а 
/ара/аитп/ге?гез! Ха 
/ара/аитп/Бтаскуътвт м 
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изипа 2) 
Гара /У1веапа в 
Гара /11веапа мм 
Гар / 135 3пад/<ши14 в 
| РатСН | Гара /У1з+апад/(шиз4 е 
Гар 3па/(шитй) в 
Гарт /Л15#3пд/<ши19/гате гъа 
Гар? /11511пд/(ши14)/заме в 
Изппа/соттеп! со 
Гара /Л1в+апа/(ши14/ соттеп+ в 
Гар / 115 3пд/<ии14)/ соптеп+ в“ 
Гар /14513пд/(ши143/ соптепт/ (509 пи14) в 
| Ратен | Гара /У1з+апад/(ши14/ соттеп+/ (5ш0 ии19) в 
Гарт /1 11 3пд/(шит4/ соптеп?/ (55 пит4) в 
сатедогу 2 
Гара /сатедогу/ (Туре? вм 
| вет | /ара/ сатедогу/ Туре? ма 
Гар / сатедогу/ (Туре? /<ши19) Мм 
Гар /сатедогу/ (Туре? /(ииз4) в 
Гар</сатедогу/<туре/<шиза) Гра 
расе 2: 
Гар</руасе гъа 
| вет | /ара/р(асе У7 
/арт/р(асе/< шиш? в 
/ара/р(асе/(шш4) в“ 
/ара/р(асе/< шиш? ве 
/арз/р(асе/4ии14)/заме в“ 
/ард/р(асе/<ши193/пеге в - 
Гарт /р(асе/<ши193/пеге а 
расе/гемем » 
/арт/р(асе/(ши14)/геутеи в“ 
/ара/р(асе/(шит4/геуден м 
| вет | /ар./р(асе/(ши19)/геутеи/пу-геутеш в - 
Гар /р(асе/(пи143/геутем/(вив ии14 в 
Гарт /р(асе/(ии19)/геутем/(5ив ииз4) в“ 
/арз/р(асе/(ши14)/геу1еи/(зшо ииз9 в 
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вегисе 


/ар3/зегудсе в 
/ар3/зегудсе ра 
| РАТЕН | /ара/зегу1се/Фии19) в 


Гар3/вегу4се/(ии14) гра 
зеагсп л 
/ард/зеагсй га 
те л 


/ар3/#1Ле/иртоай в“ 
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52. Клиентска част 


а 2 Структура на файловата система 


По подобие на сървърния софтуер, този проект за потребителския 
интерфейс също е пълен с разнообразни конфигурационни файлове. 

Тези, които са разгледани в т. 511. са: “епм", “.езпПдпоге", 
“ргешепапоге", “а Папоге", “ргешШенс", “евип!ис", “раскадезоп", “рпрга- 


Госкуат!" и Чвсопйа.)5оп". 


Новите конфигурационни файлове са следните: 


- „еапогсоппа - конфигурационен стандарт за настройки на 
развойните среди за разработка 

- „епутетроте - примерен публичен “епм" файл, който 
обозначава как трябва да бъде форматиран и какво да съдържа 
един “епм" конфигурационен файл 

- „бгуиен!ис - конфигурация за статичен на стилови С55 файлове 
и разширения 

- сдоБбаойв - конфигурационен файл за деклариране на 
глобални типове в Турезспрт: 

- пехрсопйа|в - конфигурационен файл за Мехиб5 

- р/аууипай Есопйа.|5 - конфигурационен файл за Раууупайт - за 
автоматизирано тестване в уеб браузъри за визуално тестване. 

- ро5!#с55.сопйа.|5 - конфигурационен файл за Роз: С55, който се 
използва от Тами пЯС55 

- ТаПуипасопйа. 6 - конфигурационен файл за С55 софтуерната 
рамка - ТауипЯС55 
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- упезрсопта.|в - конфигурационен файл за М(ез?!, използван за 
тестване на проекта. 


(23 едйогсоп а 


<- епулетрате 


„ез пПдпоге 


(0; 
9 езпис 
Ф 


„дШапоге 
„ргешепапоге 

(> ргешепс 

КФУ згуешигс 

718 

< ПСЕМВЕ 
пех!.соп!а.)5 

75 
раскаде.)5оп 
раумпайт.соп а.) 5 
рпрт-оск.уат! 
ро51сз5.соп а. 5 
ВЕАОМЕ. та 


15 тайу/пд.соп а .15 


мйезт.соп а.) 5 


фиг. 3.2.1. - Конфигурационни файлове във файловата структура на проекта 


В проекта има две главни директории - риб/ с и 5гс, където съответно 
се съдържа публичната информация, като статични снимки, файлове и 
текстове, и изходния Туребспрт! код. 

“вгс" директория е разделена на много подкатегории, но съдържа и 
два файла - „П8пЛ<" (конфигурационен файл за интернационализация на 
уеб приложението с пеж-и!) и “пладфемиаагелз" (софтуер, който се 
изпълнява между заявките, като „човек по средата“ или „междинен 
човек“, подобно на Интерсепторите в Ме 095. Директориите в “згс" са 
следните: 

- асиопв - съдържат се всички сървърни действия - функции, 
които се изпълняват на сървъра. Те могат да бъдат извикани 
както на клиента, така и по време на сървърното зареждане на 


страниците. Те са нова част от Мех 5 версия 13.5 
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арр - съдържат се всички страници, шаблони (ауошцув / 
Теглраге.5), страници за грешка и всички останали специални 
файлове за структурата на Мех 5 уеб приложението. 
сотропетзв - съдържат се най-малките и преизползваеми 
Веас! компоненти в приложението. 

сопйав - съдържат се конфигурационни файлове. 

сопзтап! в - съдържат се константни променливи. 

соптехЕ - съдържат се глобални обвивки на проекта - Неаст 
Соптехг. 

еггогз - съдържат се специални / разширени (сизтогп) грешки 
Вес! - съдържат се всички спомагателни функции за 
извличане на данни. 

Роокв - съдържат се всички преизползваеми Неас! Тате 
функции. 

теззадевз - съдържат се речниците, използвани от пех-п!, за 
интернационализация. 

ратайв - съдържат се т.нар. „части“, които са логически 
разделени компоненти, които са по-големи от обикновените 
компоненти и обикновено съдържат други компоненти в себе 
си. 

зсретаз - > съдържат се схемите, използвани от 204 
библиотеката, за проверка на съдържанието. 

5Г/ез - съдържат се всички С55 /5С955 стилове за даден Мех 5 
проект, тъй като този в този проект се използва само 
ТаймипяЯСб5б5, в тази директория се съдържа само „д!оба!|.с55" 
файл, който се използва с конфигурационни цели. 

Турез - съдържат се всички създадени типове, които се 


използват в приложението. 
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- иШв - съдържат се всички спомагателни функции, които се 
използват често в уеб приложението. 
- уигаррегв - съдържат се компоненти-обвивки, които се 


използват за обвивка на други компоненти 


> СЗ рибйс 
м Ва згс 
» СЗ асЧопз 


> арр 
> 3 сотропеп!в 


> СЗ сопйав 
ва изеще 
(3 сомех: 

> Г епогв 

> Отеисп 

> С поокв 

> СО теззадез 
(3 рагча!в 
(3 зспетаз 

> Пеев 

> СЗтурез 

> Ош 

> С угаррегв 
18 18п.15 


15 пий емаге.15 


фиг. 5.2.2. - Файлова структура на клиентския софтуер 


322. Конфигуриране на > връзка с  приложно-програмния 


интерфейс 


С цел консистентно използване на ОН! адрес за приложно- 
програмния интерфейс, е създаден “конфигурационен “файл 
/сопйаз/ар из), който извлича от “епм” конфигурационния файл ОВГ 


адреса на приложно-програмния интерфейс. 


фиг. 3.2.3. - Конфигурационен файл за ОВ на ППИ 


-148- 


Освен това в някои клиентски компоненти се използва Ах!о5 
библиотеката с или без ЗУМУН, вместо вградената и модифицирана от 
Чехшб5 Тетсп() функция. За използване на една инстанция на Ах!05 е 
създаден и Ахо5 конфигурационен файл (/соп аз/ахоз5Л5), в който се 


дефинира и адреса на приложно-програмния интерфейс. 


: АхтобТпзТапсе 


фиг. 3.2.4.- Конфигурационен файл за Ахоз библиотеката 


Тъй като 5УУВ приема функция за извличане на данни, е създадена 
специална функция за извличане на данни, която използва Ах!о5 


инстанцията. 


+ 
В, 


ОатаТуре> ( 


: АхТтозКезропзе<ОатаТуре 


фиг. 3.2.5. - Специална (сизгот) функция за извличане на данни за 5У/Р 


32.45. Обработка на клиентски и сървърни грешки 


Една от най-важните части на едно клиентско приложение, освен 
сигурността, е предоставянето на грешки на потребителя по подходящ 


начин. Затова в този проект са създадени няколко помощни функции, от 
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които някои са комбинирани с библиотеката 209 за клиентско 
потвърждение и верифициране на информация, докато други са 
обвързани с обработката на грешки от сървъра. 

Първо ще бъде разгледана обработката на сървърни грешки, която 
се използва за обработка на специални грешки, върнати от сървъра или 
за автоматични валидационни грешки от “с!а55-маПдатог" на Мез05. 

Създадени са помощни типове за формата на грешките, получени от 
сървъра - „МапданопЕгог" и „ЕгогВезропзе", както и резултата за 


форматираните и извлечени сървърни грешки - „ЕхиастейбегуегЕггого”. 


Ма тда?топЕггог + 4 
< г 
а! 


з слагше В сие те 


: бъгъпа; 


Ма тда?ттопЕггогзКезропзе 
: Ма тдаттопЕггог!| 1; 


ЕггогКезропзе 4 
: 5Ъгтпа; 
: 5Ъгтпа; 


Ех? гастедбегмегЕггога 4 
за 


: 6Ъъгла!: 5Ъгпо ||; 


фиг. 3.2.6. - Помощни типове за извличането на сървърни грешки 


Сървърните грешки, които се водят като познати, са разделени на 
два вида според техния код на грешка: 400 - грешно подадена заявка, или 
409 - конфликт на записи. При статус грешно подадена заявка, означава, 
че данните, които са подадени, са грешни. Следователно се очаква 
автоматична грешка от „с!а55-маПпдатог" на Ме 5. Ако пък е конфликтна 
грешка - това е специална грешка, която е вдигната или от кода на 


проекта, или от Рпзгта и обработена през Мез 5 специалния 
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интерсептор. Идеята на обработените грешки е да бъдат с единен формат 


от главен обект с обекти, разделени на грешки - масив от стрингове. 


соп5 1 ехтгасТбегуегЕггога БЕ е 
гез: Кезропзе, 
1?: (Кеу: 5Ъгпа) 51 г1па, 
): Рготтзве<Ех?Т гастедбегмегЕггогвд 4 
1 (гез. 400) 4 
соп5 + Боду (ама + гез. ()) а5 Ма! 1 да? топЕггогзКезропзе; 


соп5 + зегмегЕггогв Боду. 1 ( 
(асс, 4 сопз!гатп?5, ргорегту ) (4 
-злассо 
|(ргорегту|: ОБуест. (соп5з?гатп+5). ((Ккеу) 
Е +(С еггогв.зегмег. 5(Кеу)”) : Кеу, 
), 
с 
4), 
); 
гетигп 4 
. г 


е 4 
...бегмегЕггогв, 


1 (гез. 409) 4 
соп5 + Боду (ама! гез. ()) аз ЕггогКезропзе; 


гетигп 4 


ГБоду. 


гетигп пшШ.1; 


1 


фиг. 3.2.7. - Функция за извличане (с опционално превеждане) 


на сървърни грешки 


Обаче преди да се стигне до сървърни грешки, първо се преминава 
през клиентски такива, за се спестят заявки до сървъра и за по-бърза 
обратна връзка с потребителя. 

С тази цел са създадени функциите: Югто!Еггоге(), ехиастЕггогв() и 
ехггастТгапзштгейЕггогв(). Първата функция - Юплто!Еггогв(), се използва 
преди извикване на която и да е функция за извличане на клиентски 
грешки. Използва се за форматиране на грешките от 2ой библиотеката, 


за по-лесна обработка от извличащите функции. В нея се извиква 
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вградената Жогта!() функция, която се използва при грешките, като след 


това им се поставя тип за ключ с обект с масив от стрингове. 


ггог5 (гези1 +: ба еРагзеЕггог<ипКпоип>) 
()) ипКпомуп ц 


: 5егпай: 3 
зората е 


фиг. 3.2.8. - Функция за форматиране на грешките от 2ой 


За функциите за извличане на грешки са необходими и помощни 
типове: „ЕгогО ес!" - за форматираната грешка (вход) и „ЕхиастедЕггогв“ 
- за изходните грешки, които са под единен формат. 

гг зесъ 4 
: 5ЪъгТпо! 1; 
: въгла|: Еггогоруесъ | 5ъг1пд 1 


Ех? гасТтедЕггогд 4 
: 5Ъгд|: зЪгъпд 1 Ех гастедЕггогв; 


фиг. 3.29. - Тип за форматирана клиентска грешка от 2оа 


И двете функции за извличане на грешки са рекурсивни, тъй като 


някои полета, може да имат повече от една проверка или деца. 


(епггога: ЕпгогоБтест): 
Ех гастедЕггогва>( (асс, 


1 
Ди 


ЕггогОБуест); 


фиг. 3.2.10. - Функция за извличане на 2ой клиентски грешки в общ обект 


най < 


: ЕхЕгасТедЕггогв + 4); 


: 5ЪгТпа) 


, )) 


фиг. 3.2.1. - Функция за превеждане на извлечените 209 клиентски грешки 


3.24. „Създаване на потребителски профили, удостоверение и 


авторизация. Защита на страници и действия. 


Тъй като от Мех б 13 и нагоре има два вида компоненти - клиентски 
и сървърни, те по някакъв начин трябва да имат споделено пространство 
за съхранение на данни. В МехШб5 13.5 излиза нова функционалност, 
наречена „зегмег Аспопв" - сървърни действия. Това са функции, които се 
изпълняват на сървъра. Те позволяват и за споделено пространство за 
съхранение на бисквитки, които се перфектни за съхранение на “ассезз” 
и гейгезП" токените, които се използват за авторизация след успешна 
регистрация или вход. 

За да дадена функция да бъде сървърна, тя трябва или да започва с: 
„Уве зегмег", или самият (ако са в отделен файл от компонент) да започва 
(подобно на клиентските компоненти - „изе сПеп?!) с „изе зегмег. 

За управлението на бисквитките за токените са създадени следните 


помощни сървърни функции: зе Токепв() - за записване или 
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презаписване на бисквитки за двата токена, и де! Токепз() - за извличане 
на двата токена от бисквитките. 

Една от най-важните функции, извикани в тази помощна сървърна 
функция, е побтоге(), тъй като тя премахва кеширането, което е 
изключително агресивно с Мехиб5 13 и 14. След това се декодират 
токените, за да се прочете докога са валидни. Което ще позволи, при 


създаването на бисквитките, да се постави техен срок на годност. 


5 Зщее а ии5ърша 


фиг. 3.2.12. - Помощна сървърна функция за записване на токените за 


сигурност в бисквитките 


Другата функция е деПокепз(), при нея също се достъпва 
хранилището за бисквитки и се изземат двете бисквитки, като се връща 


обект с токените. 


фиг. 3.2.13. - Помощна сървърна функция за извличане на токените за 


сигурност от бисквитките 
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За влизането на потребител в профил са създадени две сървърни 
функции - една главна и една помощна. 

В помощната сървърна функция за влизане на потребител се прави 
заявка и се обработват нейните данни. При успех на заявката се извличат 
токените за сигурност от тялото на отговора и се връщат, както и запазват 
в хранилището за бисквитки. Докато при неуспех се връща грешка за 


невалидни данни за вход. 


извита 55иогй: 5Ъг1по): 


())) Аи? пВезропзе; 


фиг. 3.2.14. - Помощна функция за влизане на потребител в профил 


Главната сървърна функция (сървърно действие) за влизане на 
потребител също започва с извикване на функцията побгоге() и се задава 
променлива за състояние на успешно или неуспешно влизане на 
потребителя, след което се прави проверка чрез 209 за грешки във 
входните данни от формата за влизане. При успешно преминаване на 
клиентската валидация се извиква помощната функция в блок за 
събиране на грешки (гу-са?тсйп блок). Тъй като по стандарт не може да се 
извиква гедкесЦ) функцията на Мехшб в Шгу-сатсПп блок, е създадена 
гореспоменатата булева променлива. При успешен опит за влизане не 
само се препраща потребителя към главната страница, но той също бива 


ревалидиран от Мех об кеша. При връщане на позната грешка - се връща 
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нейното наименование, докато при непозната грешка се връща обратна 


връзка - сървърна грешка 500. 


сопз5Е Тод1пАс+1оп азупс (ргеубнае: ипКкпоуп, ЕогпОака: ЕогшОаха) 


повтоге(); 
Те: Точдед Базе; 


сопзъ уа 1датедОПака 1од1 п5спеша. 
: Еогидаха. (“ 
: Еогпага. 


>); 


1Е (!уа11даъедПаха. 
гетхигп 4 
: уа 1датедПага. А 5 ( (1ввче) 1з5вче. 
|; 


7 
сопзЬ (| еша11, раззиога | уа1 19а+едйаха. 


«гу ( 
Точчей амат: 1од1п(еша11, раззуога); 
геуа! 1датетаз ( "изег"); 

| саъсп (егг) 4 
1Е (егг 1пзапсеоЕ ЕогшЕггог) 4 

гетигп 4 
: |егг. 1 


1Е (1оччед) гед1гесъ(!/"); 


фиг. 3.2.15. - Главна сървърна функция за влизане на потребител в профил 


Това действие се конфигурира в клиентски компонент с 
изеЕоптзтаге(), за да се следи прогрес и грешки, върнати от функцията. 


Тя бива поставена като аспоп свойство на 395Х формата. 


сопзЕ |зЪаке, ЕогшАс+топ | ивеогтбЕаке (1091 пАс+1 оп, 11151а15Ха е); 
сопз+ + изеТтгапзТа+топз ("ап .1091п"); 


гекшгп | 
<Еогш 
асъ1оп+ (ЕогшАс+1оп) 
сТаззнаше< "ех ми-Е111 Е1ех-со1 дар-4 Еопъ-вемштро|19 зш:и-#11" 
> 


</Еогш> 


); 


фиг. 3.2.16. - Употреба на сървърните функции за форма 
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Сървърната функция за регистрация е по-особена, тъй като при нея 
не се извършва клиентска валидация или връщане на обработени 
сървърни грешки, поради факта, че тези грешки вече са били проверени 
в предишните етапи на регистрация. Подобно на помощната сървърна 
функция за вход на потребител, тук само се прави заявка и се връща или 


за успех - токени, или се връща грешка. 


Са: 5ТопирЕогтб5тате) 


пр 


Ди  НВезропзе; 


); 


фиг. 3.2.17. - Сървърна функция за регистрация на потребител 


Защитите на страниците са имплементирани както на ниво 
страница, така и още преди изписването на самата страница, на ниво 


заявка, чрез междинния софтуер на Мех Об - гиад!еууагелв. 


фиг. 3.2.18. - Проверка за регистрация на потребител и достъпността му 


ет А 


Друга функция, която е сървърна, е за проверката дали потребител 
има права за достъп до определени модифициращи функции. Тази 
функция се използва най-често за показване на бутони за модифициране 
/ изтриване, както и за достъп до техните страници. В нея се сравняват ИН 
на създателя на дадена публикация и ИН на влезналия потребител, ако 


има такъв, както се прави и проверка за ролята на потребителя. 


( 


а датите е 


фиг. 3.2.19. - Сървърна функция за проверка за права за достъп за 


модифициране на даден обект 


Друг пример за права за достъп е този за правата за гледане, който 
не е функция, а част от заявката за извличане на обява или място. Те могат 
да бъдат разгледани подробно в точки 3.2.9. и 5.2... 

Една от най-важните части в сигурността на приложението и 
правилната употреба на токените са обработката на токени след 
изтичане на „ассезз" токена и неговото подновяване с „гегезП" токена. 
Това се изпълнява от хибридната (сървърна, но се използва и като 
нормална функция в междинния софтуер) функция - 


гегез ТокепзАпабетигпАссезз(). В нея се достъпва хранилището за 
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бисквитки, като се извлича „генезП”" токен, с който се извиква заявка до 
приложно-програмния интерфейс за подновяване на „ассез5" токена. 
При успешно изпълнение на заявката се връща нов „ассез5" токен, докато 
при неуспешна, може да се върнат две грешки - при 401 - специална 


грешка за изтекъл „гейгезП" токен, докато другата е обща. 


: 5Ъгтла; 


фиг. 3.2.20. - Функция за подновяване и връщане на нов „ассезз” токен 


Тази функция се извиква на две места - или в междинния софтуер, 
или по време на заявка - от помощните функции Аш? ? () и де Аштн (). 

15 Ай?! () се използва за взимане на „ассез5" токена и връщане дали 
потребителят е влязъл в профил. Важното на тази функция е, че приема 
аргумент дали се изпълнява по време на извличане на данни от клиент, 
или по време на сървърно извличане на данни, тъй като според 
документацията на МехШ5 не може да се използва хранилището за 


бисквитки в режим записване по време на сървърно извличане на данни. 
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Обаче при тях това не е нужно, заради подновяването на токените преди 
тяхното изпълнение - в междинния софтуер. Във функцията се взима 


„ассезв" токена и проверява дали има такъв. Ако има - връща стойността 


му, ако няма - се опитва да го поднови. 


фиг. 3.2.21 - Помощна функция за проверка дали потребител е регистриран 


Другата помощна функция надгражда Ай |), като връща 
задължително токен с „Веагег“ пред него, с цел да се използва веднага за 


заявки, или празна стойност. 


фиг. 3.2.22. - Помощна функция за запълване на Аийопгайоп хедър за заявка 


Последното място, където се използва функцията за подновяване на 
„ассезв"” токена е в междинния софтуер, където се прави проверка за 


съществуващ „гейггезП" токен и несъществуващ „ассезз" токен, където се 
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извиква помощна функция за подновяване токените с хранилището за 
бисквитки на самата заявка от междинния софтуер. При каквато и да е 


грешка - 4ХХ, се изтриват всички бисквитки за сигурност. 


фиг. 3.2.23. - Проверка за нужда от подновяване на „ассезз" токена 


Във функцията се подновява токена и се създава нова бисквитка, а 
във функцията за изтриване - те се изтриват от подаденото хранилище за 


бисквитки от междинния софтуер. 


: КезропзеСооКтез ) 


фиг. 3.2.24. - Помощни функции за сигурност за междинния софтуер 


Последната функция за сигурност в това уеб приложение е тази за 
излизане на потребител от акаунт. Тази функция също се изпълнява в 
междинния софтуер, при отиване на адреса за излизане от профил. В нея 
се изземат токени, извиква се заявка на приложно-програмния 


интерфейс за излизане на потребителя и при валиден „генезй" токен, тя 
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бива успешно изпълнена и токенът е вече в черния списък, като след това 
се изтриват всички бисквитки за сигурност от уеб приложението. Те също 


се изтриват и при изтекъл „геггезП" токен. 


: Мех? Кезропзе) 4 


фиг. 3.2.25. - Функция за излизане на потребителя от профил 


325. > Настройки на приложението - интернационализация (ПЗп) и 


теми 


Глобалните обвивки на приложението се поставят в глобалния 
шаблон - гауочт.)5 файл. Тези контексти (обвивки) се слагат над децата на 
шаблона. В глобалния гауощ?|5 се приема параметър от ОН! адреса за 
език, който да бъде използван в приложението. Ако такъв параметър не е 
подаден, страницата ще върне 404 грешка. След това се извиква 
функцията за зареждане на всички съобщения (всички стрингове за 
всички езици), които след това се подават на Мехип!С"ептргомаег за 
създаване на контекста. Под него се инициализира и контекстът за тема 


на приложението - ТретеРгоидйег. Освен това, за интернационализация 


1625 


се слага атрибут за език на Ат! тага, както и се генерират всички 


статични пътища за всеки един език с депеготезтайсРагат() функцията. 


ехрогь Еипсъ1оп депегаебта!1сРагашв () 
гетигп 1оса!ез. ((Тоса1е) (4 


хрогь деваш 6 Еппс1оп ГосаТерауоч+ (4 


сит 14геп, 

: 4 Тосае |, 
: Беадому<4 

: Беас+.ВеасъКоде; 

2 в вЕгапа РР. 
Ша 
1Е (|Поса!ев. (Тоса1е)) 4 

поЕЕоппа(); 


? 
ипсЕаБте зе-Кедиез!Посате(1оса!е); 
соп5зЕ теззвадез пзеМезвадез (); 


геъигп ( 
<пЪш1 Тапа-(1оса1е) сТаззЧапе< "4 
<Боду 
сТаззнаше<+ (75 (1п+ег. 
за 
<МехъТп+1С11епъргоу1дег шезвадез- (шезвадез) > 
<ТпетмеРгоу19ег> 
<Мода1 Ргоу1дег> 
<Каутдактоп /> 
<ша1п с! аззМаше-" Е1е 
(си 14геп) 
</ша1п> 
</Мода1Ргоу1дег> 
</ТпешеРгоу1дег> 
</Мехътп+1с11еп+ргоу1дег> 
</Боду> 
</пъш1> 
); 
+ 


фиг. 3.2.26. - Част от глобалния шаблон на уеб приложението - ауош!/5 


В изходния код на приложението има два конфигурационни файла 
- в единия се задават и връщат всички налични езици, както и този по 
подразбиране. В главния конфигурационен файл се обхождат и вкарват 
в приложението всички файлове, които съдържат съобщения за всеки 


език. 


ехрог! сопв? 118п 


ехрог+ Туре Госа|е (Турео? 118п) | "Госа|ез" | | питрег!; 


фиг. 3.2.27. - Конфигурационен файл за П8п 
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фиг. 3.2.28. - Главен конфигурационен файл за П8п 


Тъй като вече приложението е конфигурирано да изисква 
задължително ОН! адресите да съдържат параметър за език, в 
междинния софтуер се конфигурира да служи за интернационализация 
с сгеатемадйеуиаге(), където са подадени всички езици, както и този по- 
подразбиране. Този междинен софтуер се използва по подразбиране, 
освен ако не се стигне до изпълнението на функциите вт. 5.2.4.. Във файла 
за междинния софтуер също се връща и конфигурация, която позволява 
на пътищата за статични файлове на МехШб5 да не им се поставя 


параметър за език. 


: Мех + Кедиез?) 4 


фиг. 3.2.29. - Междинен софтуер за интернационализация (П8п) 
Една важна функционалност за потребителското изживяване е 


възможността на потребителя да разполага с избор на светла и тъмна 


тема на приложение, спрямо ръчна настройка (светла или тъмна тема), 
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или автоматичен избор, който се синхронизира с операционната 


система. В контекста се съдържат тема и функция за промяна на темата. 


за 


Тпете 


фиг. 3.2.50. - Създаване на контекст за определяне на тема на приложението 


За да може контекстът да бъде достъпван от клиентски функции, той 
трябва да има специално създадена за него компонента функция (Неаст 
Ноок), която в себе си да извиква контекста и да вземе стойностите, които 


връща - темата и функцията за промяна на темата. 


фиг. 3.2.31, - Създаване на компонента преизползваема функция (Ноок) 


за четене и модифициране на темата 


В обвивката са дефинирани както и стойността на темата - чрез 
Веаст стае, така и функцията за промяна на темата. Освен това има две 
функции за цикъла на живота на обвивката (изеЕ Нес! ))), които се извикват 
при начално зареждане на приложението и при промяна темата те се 
използват за поставяне на класовете на избраната тема. Тази обвивка е 


разгледана на следващата страница във фиг. 3.2.32.. 
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ехрогЕ сопз ТпетеРгоутдег < (4 сп дгеп ): 4 : Кеас!.Кеас!Моде |) 
сопз? |+Пете, зе Тепе | изебтате<Тпете ипде? 1пед> ( ипде? 1пед); 


сопзт спапдеТпете (ТПете: Тпете) 4 
соп5 Е гоот м1пдом. 


си си (ФПете) 4 


соп51 дет Тп Та Тепе (): Тпемте 4 
ТР (Турео? утпдом гиП пед" мъпдом. ат 
соп5 1 5ТогедРге?5 м1пдо я (“ТНете"); 
ТР (Турео? 5зТогедРге?5 
гетигп зТогедРге?в а5 Тпете; 
+ 
+ 


гетигп "су51 


Це 


изеЕТТес( () 
се Тпете ( де Тп1 та Тпете()); 
Бо ШЕ 


изеЕТТес?( () 4 
соп5 + гоо м1пдом. 


511 сп (ТВете) 4 


: 
>, |ЕПете|); 


гетигп ( 
<ТпетеСоптех?+.Ргоутдег 
ма че-44 
Тпепте, 
спапдеТПепте , 
# 
> 
(сп11дгеп) 
</ТпетеСоптехт. Ргоу1дег> 
); 
е 


ехрог! деташ Е ТпетеСоптехт; 


фиг. 3.2.32. - Част от обвивката (провайдър) за тема 


32.6. Извличане на данни по страници (Радпапоп) 


Функциите за извличане на данни по страници с лимити са основна 
част от приложението, тъй като обяви, места, коментари, ревюта и 
множество от потребители се извличат точно по такъв начин. За тази цел 
е създадена помощна обвиваща функция на Ретс?() за извличане на 
данни, както и преизползваем компонент за промяна и управление на 


страници и лимити. 
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Помощната функция приема ОН! адрес, номер на страница, лимит, 
както и често използвани опции за заявката - кеширащи опции, опции за 
Чех 5 Тетс!() и хедъри на заявката. Във функцията се създава ОН! адрес, 
в който първо се проверява дали има ачегу параметри и спрямо това 
дали да се постави въпросителен знак на ОН! адреса. След което се 
добавят параметрите за страница и лимит, както и в заявката се добавят 
останалите опции и настройки. След това се проверява дали нейното 
изпълнение е било успешно, като също се и правят проверки за права за 


достъп (401 и 403 - забранен достъп). 


ехрогъ сопзЬ рад1паедЕексъ азупс <Т> ( 
ит: вЪъгслпа, 
раде: пипЬег, 
1316: пишрег, 
ор+10п8?: 4 
Пеадегв?: Неадегвтп1+; 
саспе?: Кедиез+Састе; 
пехъ?: МехтЕетспКедиез+Соп 19; 


7, 
: Ргош1 ве<Рад1 пагедКезропзе<т: 
сопзЕ гезропзе ама1+ Ееъс 
5 (АРТ 0681)54иг1)54иг1. 
4 
...ор+10пв, 
, 


); 
сопзо1е. ("иг1", 78(АРг 0к.)5(1г1) ?раде-5 (раде) «1114-5411 6) 7); 


1Е (!гезропзе. ра 
зу1Есп (гезропзе. ищ 
сазе 401: 
Епгот пеш НТТРОпаштрога гедЕхсер+1оп(); 
сазе 403: 
Ергом пеш НТТРЕогЬ1ддепЕхсер+10оп(); 
сазе 404: 
гетагп 


, 
) аз ипКпоуип аз Рад1па ед 


? 


Ергои пет Еггог("Еа 
: гезропзе. 


генигп (ама! + гезропзе. ()) аз Рад: пахедЕезропзве<т>; 


+; 


фиг. 3.2.53. - Помощна функция за извличане на данни по страници с лимити 


Помощната функция радпатейЕетси|) е Турезспр: Сепепс функция, 


която връща отговор от тип РадпатедНезропве, който също е Турезбспр! 
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Сепепс, тъй като данните, които връща са лимит, номер на страница, общ 


брой елементи и самите данни, които са Сепепс - тип, който се подаде. 


ехрогъ Куре Рад! пагедКезропзе<т 
в аа 
: пимшрег; 
: пошрег; 
: пошрег; 


фиг. 3.2.34. - Сепепс тип за данни за отговор на заяква със страници и лимити 


В клиентските компоненти се използват вградените функции за 
извличане на данни от ОН! адреса на приложението - път и параметри. 
При промяна на страница се сменят параметрите на ОН! адреса чрез 
помощната функция - сгеатеОиегубито|). Ако страницата надвишава 


последната страница, то параметъра се променя на последната. 


ехрогЕ соп5+ Радейр+10п5 (Х раде, Им, ЗотаШТетз >: Радедр + 1опзРгорз ) т 
соп5+ гошег + изеКошег(); 
соп5+ рат пате - изеРа пате(); 
соп5+ сеагспРагатз изебвагсПРагатз(); 
соп5+ То аТРадез Ман. (ТоТптедег( Тота ет ) ТоТптедег( 11 +)); 


соп5+ сгеатебиегубгтпа изеСа Лраск( 
(пате: 5Ъглпд, мафие: 5Егтпа) 1 
соп5+ рагат5 пем ОВ5еагспРагатз ( <еагсПРагатз. 
рагатз. (пате, уа|пе); 
гетигп рагатз. (он 
|зеагспРагатв |, 
соп<? папдТеРаде (пехтРаде: питбег) 4 


1 (пехтРаде раде) гетигп; 


гоцтег. ( 
(ра пате? ?5< сгеатедиегуб1г1па("раде", пехтРаде. 


: Та|ве, 


1 (раде > ЕотатРадез) 4 
гоцштег. ( 


“(ра Нпате ) ? 44 сгеатебдиегу51г1по( "раде", Тота Радев. 
г 


: Та|зе, 


гетигп ( 


и” 
Из 


ехрог детац | Радейр Топз; 


фиг. 3.2.355. - Клиентски компонент за управление на страници и лимити 
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32”. > Конфигурация на Соод/е Марз 


Подобно на всички останали конфигурационни файлове, този на 
Соод1е Марз също извлича от конфигурационния “.епум" файл ИН и ключ 


за достъп до приложно-програмния интерфейс на Соод!е Мархз. 


фиг. 35.2.36. - Извличане на ключа и ИН за достъп на ППИ на Соод/е Марз 


Първоначално за обратното геокодиране на Сооде Марз бе 
използвана библиотеката „геаст-деосойе", но тъй като тя не разполага с 
възможността да се подават референти ОН! адреси, тя беше премахната 
от проекта и заменена с ръчно написана компонентна функция (Поо(). 
Референтните ОН! адреси позволяват да се използват вградените 
функции за защита на Соод!е Марз ППИ, затова е създадена и помощната 


функция за зареждане на техния ППИ, заедно с ключа. 


фиг. 3.2.37. - Зареждане на ППИ на Соод!е Марз 


за използване на обратно геокодиране 


Помощната функция, която е част от изеДаагезе(), 
дегДАаагезЕготАр!) се стартира със зареждането на ППИ на Соод!е Мардв, 
след което създава инстанции на Сеосойег класа за обратно геокодиране 


(от подадените координати) и! а! апа (координати от 2 числа), след което 
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прави заявка към ППИ и при успешен резултат задава стойността на 


компонентната функция на адреса. 


соп5 + изеДддгез5 (Та: питбег, 1пд: пуотбег, Тапдачаде: зЪг| пад): 51г1па 
сопзт |аддгез5, зет Аддгезз | изезтате( "Го ПО) 


соп5 1 дет Аддгез5 Е готАрт азупс ( 
Та: питБег, 
1пд: питбег, 
Тапдчаде "еп", 
: Рготмузе<доод1е. 
ама Тоадбсгър?(); 


соп51 деосодег + пем доод1е. 
соп5 Та па пем доод1е. 


гетигп пем Рготзе((гезо|ме, гетест) 
ъгу 4 
мо19 деосодег. ( 
4 
: Та па, 


+, 
(гези 125, 5Татиз) 4 
1 (тати доод1е. 
Ше 
гези1 15 
гези1 15. 
гези115101. 
ра 
гезотме(гези1 15 101); 
| еве 4 
гетест( пем Еггог( "Сошудпт 1пд Те аддгез5")); 
+ 
| езе 4 
геуес?( пем Еггог( Сеосодег Рае дие То: 545аТи5)”)); 
+ 
То 
)5 
> са!сп (егг) 4 
гетес?( егг); 


изеЕ? Тест ( () 4 
сопз1 детАддгез5 азупс () 4 
+гу 4 
соп5 1 гез ама: детАддгез5 Е готАр| (Та, па, Тапдчаде); 
сет Дддгезз ( гез. В 
| сатсп (егг) 4 
сопзо1е. (егг); 


, 


з. 
Т, 


мо14 детАддгезз(); 
+, Па, 1пд, зе Аддгезз|); 


гетигп аддгез5; 


Та 


фиг. 3.2.38. - Компонента преизползваема функция (Ноок) за използване на 


обратно геокодиране чрез ППИ на Сооде Марз 


З17 А 


3.2.8. Извличане на обяви и коментари 


За извличането на обяви е създадена обща спомагателна функция, 
която се използва навсякъде, където се взимат няколко обяви наведнъж 
- на началната страница, при изброяването на всички обяви, при 
показването на категории, както и в профилите на потребителите 
(публични или собствени). 

Функцията за извличане на много обяви приема номер на страница, 
лимит, потребителско име, ИН на категория и токен за достъп. Всички 
тези параметри са незадължителни. След това се създава ОН! адрес, 
спрямо какво е подадено от незадължителните параметри, както и се 
подават номера на страница и лимита на специалната функция за 
извличане на данни - рад! по ейЕетс(). Освен това се подават няколко 
Мехи5 опции за ревалидиране през даден интервал и опционално - 


токен за авторизация, ако се прави опит за достъпване на собствени 


потребителски обяви. 


5пог! | 151 1пдКезропзе> ( 


фиг. 3.2.39. - Извличане на обяви 


ул - 


Следващата функция за извличане на данни е тази за извличане на 
една обява, тук се приема само един аргумент - ИН на обява. В нея се 
извиква обикновената Тес() функция, като се подава токен за 
авторизация при нужда, ако обявата е частна. При код за липса на достъп 
и права, се връща грешка, която след това се използва за показване на 


страница за забранен достъп. 


: бъг ло) 4 


) 
Н 


(Ор Ри 1 11 лдКезропзе; 


фиг. 32.40. - Извличане на обява 


Функцията за извличане на коментари е подобна на тази за обяви 


само че при нея се подават само ИН на обявата, страница и лимит. 


( 


Соттепт 


фиг. 3.2.41. - Извличане на коментари 


зА 


3.29. > Извличане на места и работа с интерактивна карта на Соод!е 


Марз 


Функцията за извличането на няколко места също се използва 
навсякъде - в началната страница, в категориите, при списъка от всички 
места, при профилните страници, както и при картата. Затова, по подобие 
на функцията за извличане на обяви, се подават страница, лимит, 
потребителско име, ИН на категория и токен за достъп. Като след това се 
създава заявка според подадените аргументи със специалната функция 


радтатедЕетс!)). 


СагдРтасе>( 


фиг. 3.2.42. - Извличане на места 


За поставяне на компонент за визуализиране на Соод!е Марз карта, 


той трябва да бъде обвит с контекста за достъп до приложно-програмния 
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интерфейс на Соод!е Марв, като му се подаде като свойство - ключа за 


сигурност на приложно-програмния интерфейс. 


<АРТРгом1дег ар Кеу<4СМАР5 АРТ!|-> 
<дуу 
сТаз5Мате+" ех П-| са с(100уй-7гет)| м-Р 1 дар-4 тЯ:П-|са|с(100уп-2гет) |! 
ге?-4рагепт) 


> 
<МарзРаг?ттатРаде ии19<4ии19 /> 
<5изрепзе Та раск-<<дту>Гоадтпа...</Ф1у> > с! 1дгеп)</5изрепзе> 
</41у> 
</АРТРгоу1дег> 
</5ИКСоп? 1д> 


фиг. 3.2.43. - Конфигуриране на обвивка за Соод!е Марз карта 


След това във всяко дете на Ар/Ргоидег контекста може да се 
постави Сооде Марз карта, като може да се добавят допълнителни 
конфигурационни настройки като ниво на приближеност, център на 


картата, контроли и ИН на картата. 


<д1у с|аз5Мате< Н-Р 1 м-Р 11 омег? Том-Нтадеп гоипдей-х1 Богдег Богдег-51гоКке Бда-рг1тагу!> 
<Мар 
200т< 113) 
септег-4 4 
Та: 42.6977, 
лос 2332195 
Ши 
Ти 1 всгеепСоптго1- аве) 
дезТигеНапа 1 1па-< "огееду" ) 
51 геет МтеиСоп?тго1-< Та|зе | 


тарТуреСоп?го1-< Тазе| 
тарТЧ-<4 СМАР5 ТО) 


<МагКкегзМар 
дата-(рТасез |) 
орепР| асе+иита 
зе ОрепРТасе-4 зе 0репРТасе! 
„> 
</Мар> 
</д1м> 


фиг. 32.44. - Визуализиране на Соод/е Марз карта 


За да иконките на местата да не се наслагват една над друга и да не 
натоварват устройството, на което е заредено уеб приложението, се 
използва т.нар. клъстър на места, който комбинира места, които са на 
много близко разстояние, спрямо нивото на приближеност / 
отдалеченост на картата. Клъстерът се използва от библиотека на Соод1е 


Марз, като при промяна на картата или данните (т.е. местата) се създава 
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нов клъстер за дадената карта. При промяна на нивото на приближеност 
се извикват функции за изчистване и добавяне на маркерите наново, като 
е важно да се отбележи, че всеки маркер има референция към него, който 


се поставя с функцията зе Магкегкей). 


соп5: с|иБТег изеКе?<МагКкегС1 изтегег пи > (пи); 


сопз1 сет МагКегКет (тагКкег: МагКег пи.., Кеу: 5Ъглад) 4 
1 (тагКег тагКег5 | кеу|) гебигп; 
ТР (1тагКкег тагКегс | Кеу|) геТигп; 


5е МагКего( (ргем) н! 
ТЕ (тагкег) 4 
гетигп 4 
„.„ргем, 
|кеу|: пагКег, 
| 
| еве 4 
соп5 + пеуМагКег5 + | ...ргем ); 
де! ете пемМагКегс | Кеу!; 
гетигп пехМагкегв; 


изеЕТТес(() 4 
ТР (мар дата) гетигп; 
ТР (1 стизтег. ре 
стизТег. пем МагКкегСТизтегег( 4 Руа 
Ш 
>, Гмар, дата|); 


изеЕ? Тест () 4 
(1! съизтег. ) гетигп; 


с|изтег. я (Ве 
с|изтег. - (Оруест. (тагКегв)); 
>, Гмагкегс|); 


фиг. 3.2.45. - Разпределение и събиране на елементи на картата в клъстер 


За всяко място се създава маркер с референция и функция при 


натискане да се отвори или затвори дадено място встрани на картата. 


<АдуапседМагКег 
Кеу-рТасе. » 
роз110п-44 
Тай: рпасе. 
19: р|асе. 
# 
опСЪ1ска4() щ 
1 (орепР|асе р!асе. 
зет ОрепРтасе(пи 11); 


> е|зе 4 
зет 0репРТасе( рТасе. 
+ 
ши 
ге?-4 (тагКег) 4 
зетМагКегКе? ( тагКкег, р|асе. 


+ 


> 
<5рап сТаз5Мате-" Тех-5Х1" >(р1асе. |</зрап> 
</АдмапседМагКег> 


фиг. 3.2.46. - Компонент за визуализация на място като маркер на картата 
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3210. Извличане на място и ревюта 


Извличането на място е създадено по подобие на извличането на 
единична обява. Подобно се извършват и проверки дали обявата е частна 


и дали потребителят има достъп до нея. 


ехрог?+ сопзт детР1Тасе азупс (ии: зЪгтпа) 4 
сопз Е аштп ама: сетДди?П( "в5г"); 


соп5 Е гезропзе < ама Тетсп(СФ(АРТ ИКСУ/ртасе/ Фиш, < 


: аи? 


Е (1 гезропзе.ок) 4 
су 11 сп (гезропзе. Дио 
сазе 401: 
Ъпгом пем НТТРУИпацтпогтгедЕхсер?топ(); 
сазе 403: 
Ъпгои пем НТТРЕогрТадепЕхсер?топ(); 
сазе 404: 
гетшгп по |; 


+ 


Тпгом пем Еггог(“Сошап" 1 Тетсп 11511л9 84 гезропзе. 


+ 


гетшгп (ама + гезропзе. ()) а5 Р(асе по; 


фиг. 3.2.47. - Извличане на място 


Функцията за извличане на ревюта по страници също е изградена 


по подобие на тази за коментари на обяви. 


соп5 1 деТтКеутеумз5 азупс ( 
ишШа: зЪгТпд, 
раде: питег Ша 
Им“: пуитбег + 12, 


соп5 1 гезропзе <- ана Е радтпаТтедЕетсп<КеутеуТуре 
/р(асе/ (пита? /гемтеи”, 
раде, 

ишти, 

< 


); 
ТЕ (| гезропзе) 4 


гетигп пш1; 


+ 


гетигп гезропзе; 


; 


фиг. 3.2.48. - Извличане на ревюта 
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321. > Качване на файлове в Ауу5 55 


Първата стъпка за качване на файлове в 55 е извличането на 
удостоверен ОН! адрес за качване на файл в кофата. Тъй като качването 
на файлове е защитено, се изисква преминаването през приложно- 
програмния интерфейс за получаване на удостоверен ОН! адрес за 
качване, както и уникален ключ за самия файл. След успешно изпълнение 
на заявката, се очаква връщането на ОН адрес за качване чрез РОЗТ 
заявка, ключ на файла, както и публичен ОН! адрес за достъпване на 
качения файл, който често се използва във функциите за качване на 


даден ресурс, като се подава ОН! вместо самата снимка. 


засега: 
: 5Ъгъпа; 
иберипар 


фиг. 3.2.49. - Извличане на линк на удостоверен линк за качване в АИ/5 53 


След получаване на удостоверен ОН! адрес за качване на снимка в 
АуМ5 55, може да се изпълни функцията за самото качване на файл в 


кофата - ир/оай53). За нея се подават файл и ОН! адрес, като след това се 


07 -< 


изпълнява РОТ заявка към удостоверения адрес на АУМ5 55 кофата. 


Помощната функция връща булева стойност - дали е изпълнена успешно. 


|: 5Егла) 


фиг. 5.2.50. - Функция за качване на файл в АМ/5 5 с РОТ заявка 


3.22. Създаване на място 


Качването както на място, така и на обява се извършва изцяло на 
клиентско ниво, тъй като се изпълняват много валидации и 
същевременно качване на файлове. Те са разделени на 2 функции - 
помощна, която се изпълнява накрая - самата РОЗТ заявка за качване на 
дадения ресурс, и главната функция, която извършва цялата валидация и 
качване на снимки в АуУу5 55. 

В помощната функция сгеагейиасе|) се подават готови данни, токен 
за достъп и ОН! адреси на снимките. В нея се извършват форматирането 
на тялото и заявката за качване на мястото. 

се( 


: СгеатеР|асеРогп, 
| педИг1Везропзе( 1, 


фиг. 3.2.51. - Помощна функция за извършване на заявка за качване на място 
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Главната функция приема всички данни от формата, снимките, както 
и получава клиентска функция за показване на грешки и преводи. 
Първата проверка, която се изпълнява, е за това дали потребителят е 
регистриран, след това се проверяват, заедно с помощните функции, 
обяснени в точка 35.2.5., дали данните от формата и снимките са валидни. 
След това се продължава с още няколко проверки, които не са показани 


на фиг. 3.2.52., дали данните са празни. 


( 


5: Раг Та|<СгеаТтеРТасеЕггогв>) 


( 


5: РагтТа|<СгеатеРгодистЕггогв 


) 4 


фиг. 3.2.52. - Първа част от функцията за качване на място - валидиране 


След успешна клиентска проверка, функцията продължава, като 
първо взима удостоверени ОН! адреси за всяка снимка с помощна 
функция, която обхожда всяка снимка и създава Ргопиве за нея. След 
успешно извличане на удостоверените за качване ОН! адреси, започва 
подобен процес, но за качване на файловете в АУМ5 53 кофата. След това 


се извършва проверка дали качването на снимките е било успешно, ако 
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не е било, се връща грешка на потребителя. Ако всичко дотук е било 
успешно, се извиква помощната функция, описана на фиг. 3.2.52. и се 


връща нейния отговор. 


соп5 | 5тапедИг 15 ама! дет5топедИг 15 (1падез, дата. 
ТоКеп); 
соп5+ ир(оадКези|+5 ама + ирТоадТтадез (5 1дпедйг15, 1тадез); 
соп5 1 Р1па|Еггогв ир|ТоадКези1 +5 
(ре) 
И) Еггог и 


ТЕ (Етпа|Еггогв. ша 
напдтеЕггог( 4 фа шаевгоге Те 
гетигп; 


и 


сопз! гезропзе ама: сгеатеР|асе(дата, 51дпейШг15, Токеп); 
1 (| гевропзе.ок) 4 
соп51 115 11па (ама 1 гезропзе. ()) аз 4 
з суми 
ЩЕ 
папдтеЕггог( 4 : |11511пд. 
гетигп; 


и 


гетигп (ама! гезропзе. ()) аз РТасе; 


фиг. 3.2.53. - Втора част от функцията за качване на място 


3.215. Създаване на обява 


Процесът по качване на обява е разделен по подобен начин на две 
функции. Помощната функция сгеатешзипо() е разгледана на фиг. 3.2.54.. 


ехрог+ азупс Типс Топ сгеате 151 1па( 
151 1лдЕогт , 


пи. : дата. 


: въопедиг1в. (Сиг|.) ш1. 


г 


гетигп Тетсп(54АРТ ОВГ)/11в1 ла“, 


за 
: “арръсатто 
: ТоКеп, 


(Боду), 


фиг. 3.2.54. - Помощна функция за извършване на заявка за качване на обява 
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Процесът на функцията за създаване на нова обява е почти 
идентичен с тази за създаване на място, но проверките, параметрите и 


помощните функции са за качване на обяви. 


ехрогт сопз51 папд еСгеате! 1571па азупс |( 

дата: Сгеате 151 1пдРЕогп, 
Ттадез: ТпадеТпри+Ргор5!1, 
папдтеЕггог: (пемЕггогв: Раг! Та <СгеатеРгодистЕггогв>) мота, 
1: (Кеу: 5Егтла) 51г1па, 

+ 
соп5! ТоКеп < ама дет Аштън 
ТЕ (|! токеп) 4 

папдтеЕггог( 4 за Мой 

1 109 

гетигп; 
и: 
соп5 + гези| + сгеате! 1511 па5сйепа. (дата); 
соп5+ 1тадезКези| + сгеатеТтадез5сПепа. (Зтадез); 
Дет пемЕггогв: Раг та <СгеатеРгодис+Еггогв ро 


ТЕ (1гезш +. ри 
соп5 1 Тогмат Тед ТогтматЕггога( гези1 1); 
пемЕггогв + 4 
..„пемЕггогв, 
.. „ех гас?ТгапзТатейЕггого ( гогта Тед, +), 
Та 


1 
щ 


ТЕ (| 1лмадезКези1+. Ше 
соп51 Тогтма Тед ТогтматЕггого (1 тадезКези 11); 
соп5 1 ехтгастед ехтгас ТгапзТаТедЕггога ( Тогтма? Тед, 1); 


ар Щ 
ехтгастей|" гоо?" | 
Аггау. (ехтгастей| гоо+" |) 
ехтгастед|! гоо" 1. 
( 
пемЕггогв + 4 
..„пемЕггогв , 
: ехъгастед! 


Па 


соп5 Е зТопейШг|5 ана 1 дет5 1 опедИг15 (1падез, дата. , ТоКеп); 
соп5+ ир(оадКези1 #5 ама“ ир(оадТтадез (5 1опейг 15, 1пасез); 
соп5+ 1 ла|Еггогв + иртоадКезш+5 


((гез) гез) 


(0) 


ТР (#ала|Еггогв. Ди 
папдТеЕггог( + : ЕЯа|Еггогв )); 
гетигп; 

Е 

ар 


соп5+ сгеате 15 1поКезропзе - ама 1 сгеате 15 1по(дата, 5ЪопедОг15, 
1 (| сгеате 151 1покевропзе.ок) 4 
соп5? 1151 1па (ама: сгеате 157 1поКезропве. ()) аз < 
з 5Епепа: 
а 
папдтеЕггог(<4 : Дъб. 1 +); 
гетигп; 


д: 
1 


гетигп (ама! сгеате! 157 1лдКезропзе. ()) аз Ри 11 151 1лдвезропзе; 


фиг. 3.2.56. - Втора част от функцията за качване на обява 
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3214 > Качване на коментар и ревю 


За разлика от предишните две функции за създаване на клиентско 
съдържание, тези две са сравнително по-прости и затова се изпълняват 
на сървъра, което ги прави сървърни функции. 

Във функциите се спазва следния процес на изпълнение, първо се 
иззема съдържанието от формата, след което се проверява дали е празно 
и се връща грешка, ако е. След това се премахват всички празни 
пространства в началото и края и се проверява със 209 функцията. При 
възникване на грешки - те се връщат като съобщения на потребителя. 
След цялото това валидиране на съдържание се прави проверка дали 


потребителят е регистриран, ако не е - връща се грешка. 


: бъл; 


51г1пад; 


фиг. 3.2.57. - Първа част от функцията за качване на коментар на обява - 


валидиране на данни 


162 


След това се прави опит за качване на коментара или ревюто, като 
при успешно публикуване, се ревалидират таговете за кеширане на 


коментарите / ревютата под дадения пост и функцията връща истина. 


: ЕхбгасТедбегмегЕггогоа 


фиг. 3.2.58. - Продължение на функцията за качване на коментар на обява - 


създаване и изпълнение на заявка към ПИ 


Качването на ревю е подобно на качването на коментар и може да 
бъде разгледано във файла „/5згс/аспопз/гемемлв" на електронния 


носител или в СЕНиБ хранилището. 


3.25. Качване на оценка 


Друга проста функция за качване на потребителско съдържание е 
тази за оценяване на потребители. Тя също е сървърна, но не използва 


НТМЕ форми за нейното изпълнение. Тя приема потребителско име, 
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стойност и тагза ревалидиране (на даден потребител). Първата проверка, 
която се извършва, е дали потребителят е регистриран, при успешно 
преминаване се извършва РОЗ5Т заявката за оценяване на друг 


потребител. 


фиг. 3.2.59. - Сървърна функция за публикуване на оценка 


3.26. Търсене - глобално и частично 


Функцията за търсене приема един задължителен аргумент - самото 
търсене, като разполага и с 5 по желание - ИН на категория, номер на 
страница и лимит. В зависимост дали категорията е подадена, се 
изпълняват две различни заявки. При неподадена категория се извлича 
кратка информация за глобалното търсене. Ако е подадена, се извлича 
спрямо категория, страница и лимит на страница с помощта на 
радтпотейЕетсй() функцията. Функцията за търсене може да бъде 


разгледана на фиг. 5.2.60., която се намира на следващата страница. 
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ехрогъ сопз+ детбеагст авупс ( 

зеагсп: вЪгтпа, 

сакедогу?: зЪг1па, 

раде 1, 

Дата + Па 

4 
1Е (сатедогу ипде 1пед) 4 
сопзЕ гез амат Бенсп(75(АРТ ОВП.)/веа агсп-5 (веагсъ))”, 
: 4 
2 160, 


МИ 


геншгп (ака! Е гез. ()) аз С1оБа1 5еагспКези1+; 


г 


генцгп рад1патедЕетсп<беагситуре> ( 
/в зеагсп<5 (зеагсп ) всагедогу-5 (сатедогу;, 


фиг. 5.2.60. - Функция за извличане на търсене 


В компонента (част от него показана на фиг 3.2.61) за търсене се 
извличат данните, като се подават на де:зеагс() функцията - търсене, 
категория, страница и лимит, от които всички, без зеагсйп, може да са 
ипаейпеа. Ако категорията не е посочена, това означава, че търсенето е 
глобално, ако е - се извличат отговор със разделение по страници, както 
и общ брой на елементи. 

ее 


сопз+ дата ама детбеагсп(зеагсП, сатедогу, раде, Или); 


1 (саТтедогу ипде? 1пед) 4 
гетигп 
<5еагсПигаррег> 
<б1ора15еагсп дата-4 дата аз С1оБа|5еагспКезш1 +) /> 
</зеагспигаррег> 
); 


15 
2 


соп5+ 4 : сатедогуПата | дата а5 РадтпатедКезропзе 
5Пог! | 15 1пдКезропзе СагаР(асе Увег 


соп5+ | Тота|Сошпт ) дата аз РадтпатедКезропзе 
5Пог! | 151 1пдКезропзе СагаРтасе Увег 


фиг. 3.2.61. - Извличане на резултат от търсене и разпределение спрямо вида 
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3217. Извличане на публичен или личен профил 


Създадени са две отделни функции, които се свързват с различни 
пътища на приложно-програмния интерфейс за извличане на данни на 
потребител. Първата функция де! зе) е за извличане на данни, до които 
имат достъп всички - публичен профил на друг потребител. Функцията се 
извиква с подадено потребителско име и без изискването на каквато и да 


е авторизация. 


: 5ЪгТпад) 


()) РиБ11сРго? 11е; 


фиг. 3.2.62. - Извличане на информация за публичен профил на потребител 


Втората функция де: Рготе() единствено се нуждае от токен за 
достъп. Спрямо него приложно-програмния интерфейс разбира кой е 
потребителя и връща както негова публична информация, така и негова 


защитена / частна такава. 


: 5Ъгпа) 


()) ИзегРго? Це 


фиг. 3.2.63. - Извличане на информация за собствен профил на потребител 
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Обаче информацията, която е нужна за визуализирането на 
потребителските профили не е достатъчна, тъй като това извлича само 
потребителските данни, без неговите публикации - обяви и места. Затова 
примерна употреба може да се разгледа на фиг. 35.2.64., където една от 
горепосочените функции се използва в съчетание с функциите за 


извличане на обяви и места за даден потребител. 


фиг. 3.2.64. - Примерна употреба на функциите за извличане на данни - част 


от извличането в профилна страница на регистриран потребител 
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Глава | М 


Ръководство на потребителя 


АЛ. Инсталация 


Предварително инсталиран софтуер може да включва: ай, прга, 


рпрга, поде и други. 

СИ: 

- За инсталиране на а! на М/пяомув: НЕ рз//ай-вст.сот/ 

- За инсталиране на а! на гпасО5: 
>>> хсойе-з5ейес! --пза!! 

- За инсталиране на ай на СМИ/ пих: 
>>> Гобщ пример раскаде топ тзтай ста! ай 
>>> |деБгап/иБип!ш! зиао ар? изта! а 


>>> |агс! | зидйо растап -5 дай -у 


МММ (Мойе Мегатоп Мападеп) - за инсталиране на различни версии на 


поде.)5 и тяхното менажиране (проектът използва м20.0.0): 

- За инсталиране на пугп на МИипЯоуив: 
РЕЕрз//апри.сопусогеурийег/пут-уипаоуиз/гейвазез 

- За инсталиране на пугп на гласО5: 
>>> Бгеуи бай пут 

- За инсталиране на пулт на СМИ/ пих: 
>>> сиП НЕ рз//гаууа#ибизегсоптепсоту/сгеайоп!х/пумт 

/у0.39.7/пвтай зи | БазВ 


>>> зоигсе +/Базйгс 
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Инсталиране на Моде)5 и МРМ с МУМ: 


>>> пут изай 20.10.0 


Инсталиране на РМРМ: 
- Мипдоуив: 

>>> Гуг АЕ рз//дещрпрт.го/пвта!|о81 -изеБ | Пех 
- РОЗК (гпасО5 и СМОЛ пих): 

>>> си -К91 Нирз//зещрпрт.го/пзта,ви | зВ - 


Инсталиране на ОосКег: 


- У/тдомув: ВЕ р5//досз.адоскег.сот/аезктор/пзта!/митаоуиз- за 
- гласО5: ВЕ рз//досз.доскег.сот/аезктор/пзта!/тас- за 
- СМОЛА пих: Р рз//досз.доскегсот/епапе/пзта/ 


41. Инсталация на базите данни 


За предпочитане базите данни (Розтоге5 ОГ и Нед!5) се изпълняват в 
ПосКкег контейнери. За тяхното инсталиране трябва да се следват 


следните инструкции: 


Бед: 


Създаване на ПосКег Мо игпе за съхранение на данни - “гед!15-дафа". 


досКег моите сгеате гед15-дата 


фиг. 4.1. - Създаване на Поскег Моите 


След това трябва да се създаде контейнер, чиито параметри 


посочват порт, на който се използва, наименование на контейнера, какъв 


з169- 


гпаде от Поскег НиБ да използва, както и да се пояснят пароли за детацши 


потребителя на базата данни. 


досКег гип -9Х4 
-П гедъв Х 
-е ВЕОТ5 РА55у/ОК0егейъв ХА 
-м гедъз-дата: /дата Х 
-р 6379:6379 « 
--пате гедъз 4 
--гезтаг! ацмаув Х 
гед15:5.0.5-а1ртпеЗ.9 /Бъп/зй -с "гед5-зегуег --аррепдопфу уез --гедитгеразз 54КЕОТ5 РАЗ5БМОКО) 


фиг. 4.2. - Създаване на контейнер за база данни - Веа!6 


Розгаге5 ос 
За създаване на контейнер с параметри по подразбиране със 
следната команда. Като повече параметри може да бъдат разгледани в 


документацията на страницата на официалния контейнер. 


досКег гип --пате розтдгез -е РО5ТОКЕ5 РА55ИОКО-тузесгетраззмогд -9 розТдгез 


фиг. 4.3. - Създаване на контейнер за база данни - Розгогез ОГ 
4.1.2. Създаване на Аглпагоп 55 ВисКкет 
Първата стъпка е да се създаде Аглагоп АУМ5 акаунт на: 


ПИгру//ауув.аглагоп.сот/, и да се обвърже със Вашата банкова сметка. След 


влизане в АУ/М5 конзолата. 


ОС. беагсп ОрЧоп+5; 63 Гач Ф е м.упота т Ккаоуап т 


ЕД 
Воаз б соцдеом 


Сопво!е Ноте «. орманите 
:: Кесеп Чу м5Ией го Б : АррЦсацопв (0) го В 


Весо: 05 Еасе (М. Мгойма) 


я 2 > 
2 из-еави-1 (Ситепе Ведоп) | | О, ид аррйсаноп 
в 
1 
ВиШпа ап Со5: Мападетеги: 
ВО акнацетгогсзиирв Мате а | Оезйрноп у | Ведюп 7 | опа! 
МА 8. беа 
Мо аррИсайопз 
СоидЕгопе бей 5таггей Бу сгеайпа ап аррйсаНоп. 
Сегисате Мападег Сгеа!е аррИсаНоп 
Мем ай зегисез р. бо 40 туАррИсаКопз И: 


(3) Соцйбней  Ееедраск Ф 2024, Атагоп МеЬ 5егМсез, пс. ог Из аНШаке,, | Рпуасу > Тепиз > Соое ргебегепсез 


фиг. 4.4. - Интерфейс на АИ/5 Конзола 
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За създаване на 55 кофа, трябва да се навигира до 55 интерфейса. И 


там да се избере „Сгеате Виске!" за създаване на нова кофа. 


#3: зегмкев | Д беагсй ГОрНоп+5 1 а А (9) (С сова т каоуап т 


В а бр сопавгоге 


Атагоп 55 х Атагоп 53 


Вискей5 » Ассоип! зпарзно+ Меуи 5Еогаде еп дазпЬоага 


Ассезз Сгап!5 бтогаде |епз ргом4ез МУБИЩу пко згогаде изаде апЯ асбуку 1гепдв. Геагл тоге. Ран 


Ассез5 Роз. 


ОЖес! Гатда Ассезв Роз 


бепега| ригрозе БисКе!5. Огестогу БисКе!5 
Мий!-Кефоп Ассезз Рой! 
Ва!сп Орегацопз 
ТАМ Ассезз Апаугег Гог 53 бепега| ригрозе БисКей (1) го 


ЕеереСИ 


я Й Виске!в аге сопгайлетгъ Рог даа згогей п 53. Сеат тоге Я 
ВосК РиБПс Ассезв зе по ог 


1315 ассошп 


| ОД. Епа Бискев Бу пате 1 Ф 
"7 5гогаде еп 
А 1 у ка 1 Ка 
равноагде Мате АМ/5 Недоп | Ассез5 | Сгеа оп дайе 
Ецгоре (ЕгапК ит) ец- Запиагу 25, 2024, 
зтогацейелз огоцре (0) Чепя епа Ре : ОЩес!5 сап бе риБйс Ц 
септа-1 пати 11:21:27 (и7с+02:00) 


АМу5 Огдатгайопв зе пд5 


Реабиге зроШане (Ф) 


Соцдбпей ЕеедБаск 6 2024, Атагоп У/еЬ бегмсез, пс. ог #5 ай Шакез. Рпмасу “ Теп5 “ СооКе ргебегепсе5 


фиг. 4.5. - Атагоп 53 


След избиране на името и конфигурация по Ваш избор на 55 кофата. 
Може да разделите кофата на директории. И след това трябва да се 


надстрои конфигурацията за риб!с-геай АС! в Репп!взопз таба. 


95 011 бегев | Д беагсй ГОрНоп+51 ММ А О 8 6 соат каоуап т 


Ва бб сопдвог: 


Атагоп 53 х Атагоп 53 Ф Вискев > (еп епа 


(епяепд 


ВисКе!5 


Ассез5 Сгап!в 


Ассев Рой ОЩМесв РгорегНе5 Регт!5510п5 Мешс5 Мападетеп! Ассез5 Рот! 
ОЩес! Гата Ассез5 Рой! 

Миш-Ведюп Ассез5 Ром! 

Ва сн Ореганопз Ощесб (4) го 

ТАМ Ассез5 Апаугег Рог 53 (6) 


АсЦопз 7 


ста 


ВосК Рийс Ассезв зе Нпаз Рог ОКес5 аге Тпе Гипдатепта| епйНез зЕогед п Атагоп 53. Уои сап изе Атагоп 53 пуепогу Г? Го дега 05 оЕай обесв п уоиг Биске+. Еог 
оНегв |о ассезв уоиг оЩес!, уош1 пеей (0 ехрИсту дгап «Нет регт/вопз. еагп тоге 2! 


115 ассоцп 


У Зкогаде Целз ОС. пад обресез Бу ргейх 1 е 
ОазнЬоагд5 
О Мате Ал Туре ка Газ: тод ед Е ка | Бтогаде с1а55  У 
ЗТогаде Гепз дгоир5 
Е < О ПУ сот/ Еощег - < Д 
АМу5 ОгдатгаНопв зе: Нпд5 
О П од / Еощег - - я 
ш ПЛ 09/ Еоег - 3 я 
Ееабиге бройна иа 
е О ГО жротЬ/ Еоег - - - 


ез Соцшдбней ЕеедЬаск Ф 2024, Атагоп М/еЬ бегМсе5, пс. ог Из ай Шайев. Рпмасу. Тептя СооЖе ргейегепсе5 


фиг. 4.6. - Конфигурация на АИ/5 53 кофа 
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За взимане на информацията за достъп - ключове за достъп. Трябва 
да се избере потребителското име от навигационното поле и след това 


да се избере линка „зесип?у сгедепта!<". 


га Рач (2) () бора т 


Ассоип! Ш: 0297-9655-3024 


АссоипЕ 

ОгдатгаНоп 

Б5егисе Опота5 

В Шпо ап Со5: Мападетеп! 


бесиг!у сгедепна!5 


5 -- 


фиг. 4.7. - Навигационно поле за потребител 


След това се създават тайни ключове за достъп с „Сгеайе Ассезз Кеу“ 


- 23 ключа на име: 
- АУМ5 АССЕ55 КЕУ 10 
- АММ5 ЗЕСВЕТ АССЕ55 КЕУ 


Ассез5 Кеу5 (1) Сгеайе ассез5 Кеу 


Уве ассез5 Кеу5 То зепд ргодгаттанс са То АУ/5 #гот Фе АМ/5 СП, Ауу5 Тоо!5 ог Роуиегбие(, АМ/5 50Кз, ог Фес! Ау/5 АР! сай. Уои сап 
паме а тахитит о? Тууо ассез5 Кеуз (асйуе ог !пасйме) а а те. |еагл тоге А 


фиг. 4.8. - Създаване на ключ за достъп 


4.1.5 Създаване на Соод1е Марз АР! ключ 


Първата стъпка е да се създаде Соод!е акаунт, като след това трябва 
да се обвърже банкова сметка с него и тя да бъде потвърдена. След това 
може да се продължи към платформата на Соод!е за Соод1е Марз - Соод!е 


Марз Ра(Чогго. В нея трябва да се създадат две неща - ключ за достъп до 


537 


Соод1е Марз приложно-програмния интерфейс и специална Соод!е Марз 


карта, на която да може да се използва идентификационния номер. 


Сооде Сюца 


е епзеп ст | Зеагсй (/) Гог гевоцгсев, досв, ргодис!в ап ппоге 


"6 


| дъ зеатев | ен по 


9 Соод/е Марз РаЧопт 


| Фо окемен 
ВТ АР15 апд зег/сез 
Ш  Мешсв 
Е 0ойаз 
о+ Кеуз апа сгедепиа!5 
а: Зирроп 
ЗойшНоп Пгагу 


Мар тападетем. 


Оаца зе! 


1 Вееазе поез 


88 
п 
Ф  маряуез 
з 
Е 


Оуеглем АЙ Сооце Марз Ратгогт АР5 » 


2 сейтпо стапед 
Ш Ведиез?в Бу АР! (аз:30 дауз 


а Пеагп Пом 10 (врау а Сооде Мар 
ВРТ еагп Ноу 1о таке уоиг Агв АР! сай! 
ВЕ сасшае риста апа зе  Бийде!5 


2 оксоуегапа епаМе АР15 


4» ЕпаБей АР! (аз30 Чаув 
АР Ведиезйв. 
беосойпа АР! 21.300 


Марз „ауабспр! АР! 989 


И ЕАЕМ 


2! 


3.000/щау 


2,0004дау- 


т00ощау 


Рад 


Зиеет Мел РиБИвН АР! Й 
ЗиеегМем Занс АР! И Провеон 
зе сезчетас --е беосойпа АР: 446/бау 
Марв Зханс АР! 


Расез АР! 


В Ееь 2024 
-в Марз )ауаЗспр! АР!: 13/Чау 


тво 


15 Ее 2024 22 Еев 2024 


фиг. 4.9. - Начална страница на Сооде Марз Райопт 


За създаване на ключ за достъп трябва да се отиде на страница „Кеуз 


апЯ сгедепца!в" в страничното навигационно поле. Като след това се 


създава ключ за достъп чрез бутона „СНЕАТЕ СВЕОЕМПАГО". 


Е Сооде Соца ме: 


епя еп ст | | Зеагсй (/) Гог гезоигсев, досз, ргойис15 ап глоге 


| беа | внао 


: е 


9 Соод/е Марз Ра огт 


Оуег/ем 

ВРТ АР!5 апй зегисез 
Що Мешсз 

В дщоз 

со:  Кеуз ап сгедепиа!в 
ра Зирроп 

69 вошйоп Пгагу 

ПО мартападоетеп 
Ф  Марзуез 

зе Оайа зе! 


Е  Кееазепоез 


Кеуз апа сгедепиа!5 А боосйе Марз РаЧопт АР » А СКЕАТЕ СКЕОЕМПАСЗ 


То Мем ай сгедепа!5 Мзй Сгедепиа!з 1п АР!з ап зегисез 


А Вегегег 10 сопбдиге е ОАШ! сопзеп! зсгееп у/#Н погтайоп аБош уоцг арр!сайоп. 


АР! кеув 
Мате Сгеайоп дайе. Весиснопз 
Фмарз АР! Кеу. 29 Оес 2023 НТТР гебеггегв е 


ОДит 2.0 Спет 05 


Мате Сгеайоп дате 4, Туре 


Мо ОД спете 10 Фврау 


Зеги/се Ассоштв 


Етай 


Мате + 


Мо зегисе ассошп 1о Фвоам. 


ЕАМ 


СОМНСИКЕ СОМЗЕМТ ЗСВЕЕМ 


АсЧопс 


ЗнОМ/ КЕУ 1 


АсЦопв 


Спем 10 


Мападе зеги/се ассоитз 


АсЦопз 


фиг. 4.10. - Страница „Кеу апа сгедепиа!в” на Сооде Марз Райюпт 


Като при неговата конфигурация задължително трябва да бъдат 


избрани услугите за геолокиране, използване на карти и геокодиране. 
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Както и с цел сигурност, да бъде защитен за употреба на позволени 
домейни: 
А00 

Е Еег Етегргорепу пате огуаше е 
О за умерзпе Еди: 
ш #.каоуаплесн/+ 7 
ш 192.168.1.198:3000/+ 7 
о 192.168.1.200:3000/« 7 
О пИр://192.168.1.198:3000/+ 7 
о НИр://192.168.1.200:3000/+ ” 
О Ннирв:/Лепз!епд-деу.Каоуаплесп ” 
О пирз:/Лепз!епа-деу.каоуаплест/+ ” 
О каоуаплеси Ра 
О 1епз!епд-готепа.мегсегарр/ ” 
о Госайо5:3000/« Ра 


фиг. 4.П. - Защита чрез разрешаване само на определени домейни 


За създаване на специална карта и извличане на нейното 10, трябва 


да се отиде на страницата „Мар гпападегпеп"" и с бутона „СВЕАТЕ МАР 10”, 


то да бъде създадено. 


“, 


фоввие 


Сооде Сюца е (епзепд 7 | Зеагси (/) Гог гевоигсез, дос, ргодисв ап поге | О, Зеагсп вопо : Ф 
Сооцд/е Марз Ра оп Мар тападетепт ЕЗСКЕАТЕ МАР 10 ЕЛЕН 
дирроп: 


о Изтд а Мар 10 2 оп Марз ЗОК Гог Апйго!й ог Марз З0К Гог 105 1Пддегз а тар |оад На! 15 спагдей адатз! пе Оупапис Марз ЗКИ. Зее Соойе Марз Ша 2 


ог тоге и огтайоп. 
Зошноп ШЬгагу. 


Мар тападетеп! 
Стеа1е ап тападе уоиг тар 05. А тар 0 5 а итицие еп Пег1а! гергевегз а зпа!е пзпапсе оГ а Сооще Мар. |еат тоге Бош тар 05 2: 


Мар Зуев 


Оаа зе15 Е НМег РЩегтар 05 я 


Мате Мар (0 Туре 
Вейеазе пойез 
ГепзепаМар. а80с!727749412е6 „амабспри - Казтег 


фиг. 4.12. - Създаване на Мар 10 на страница „Мар Мападетепт” 


4.4. Инсталация на приложно-програмен интерфейс 


Първата стъпка, която трябва да се изпълни е да се клонира (изтегли) 


СИНиР хранилището на приложно-програмния интерфейс: 


>>> до! сопе Ни рз//а#Нир.согп/кокозТесП/епяепа-раскепа 


>>> са епзепд-БасКкепа 
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>>> рпрга лета! 


Попълване на „епм" конфигурационен файл: 


ОПАТДВА5Е ПР +" розТагеза1: //<ИМЕ БАЗА ДАННИ> : <ПОТРЕБИТЕЛСКО ИМЕ> 
В<ДОМЕЙН ИЛИ ТР АДРЕС>:<ПОРТ>/<ИМЕ БАЗА ДАННИ> 

?вспета<риБ 11 сброо| Е1теоит<158соппесттоп | <5" 

ЗМТ БЕСВЕТе"<КЛЮЧ ЗА КОДИРАНЕ НА ЗМ АйТН>" 

ЗМТ ЕХРТКЕ5 Те "14" 

ЗМТ ВЕЕВЕЗН БЕСВЕТ<" <КЛЮЧ ЗА КОДИРАНЕ НА УМТ ВЕЕВЕЗН>" 

ЗМТ КЕЕКЕ5Н ЕХРТКЕ5 Тм-"З0а" 

# КЕО15 

ВЕОТ5 ОВ +" гедъв: //<ПОТРЕБИТЕЛСКО ИМЕ>: <ПАРОЛА><ДОМЕЙН ИЛИ ТР АДРЕС>:<ПОРТ>" 
ВЕОТ5 ИБЕВМАМЕ< "<ПОТРЕБИТЕЛСКО ИМЕ>" 

КЕОТ5 РА55ИОКО<" <ПАРОЛА>“ 

КЕОТ5 МАМЕ<"<ИМЕ>" 

КЕОТ5 ПАТАВА5Е<"0" 

# Аи5 

Ан5 53 КЕСТОМ+"<РЕГИОН 53>" 

Ам5 АССЕ55 КЕУ Т0<"<10 КЛЮЧ ЗА ДОСТЪП 53>" 

Анб БЕСВЕТ АССЕ55 КЕУ<"<КЛЮЧ ЗА ДОСТЪП 53>" 


Амб 53 ВИСКЕТ МАМЕ+ "<ИМЕ КУТИЯ>" 
Анб5 53 РОГОЕКЕ"<ИМЕ ДИРЕКТОРИЯ>" 


Ам5 СГОШОЕКОМТ ОКГЕ"<0КС ЗА СГОЦОЕКОМТ" 


МООЕ Ему "деметортеп+" 
МЕВ5ТОМе"0.0.1" 


фиг. 4.13. - Конфигурационен “епу" за клиентски софтуер 


>>> рпргп згагдем 


4.5. Инсталация на клиентската част 


Първата стъпка, която трябва да се изпълни е да се клонира (изтегли) 
СИ Нир хранилището на клиентската част: 

>>> до! сопе Ни рв//а#Пчр.соп/кокозТеспЛепаепа-оптепа 

>>> са |епя епа-оптепа 

>>> рпрга илзгай 


Попълване на „епм" конфигурационен файл: 


МЕХТ РИВЕТС 0006ГЕ МАР5 АРТ КЕУ<< КЛЮЧ ЗА 000СГЕ МАР5 АРТ> 
МЕХТ РИВШТС 6006ГЕ МАР5 10<<10 ЗА С00СЩЕ МАРА 10> 

МЕХТ РОВЕТС АРТ ИВ +А+Ърв: //(епзтепд-ар1. Катоуап.Тесй 
МЕХТ РОВЕТС ОК +АЪЕрв: //(епзепа. Катоуап.Тесй 


фиг. 4.14. - Конфигурационен “епу" за клиентски софтуер 


>>> рпргп дем 


5195 


4.1.6. Вдигане на софтуера в облака 


За менажирането на домейни 


платформата Соцанаге. 


и събдомейни 


се използва 


В) 5 регвопа! Чазй.соце аге.сопудс7де5596569657!8с387741с62седЬ0/каюуаплеста": 
В 3 А 
съоцр В Фабазе ДО бирромто Епфват 4 т 
< Ккаюуаплесп » 
0м5 
В ожелен Кесогдв 
Мападе ОМ5 гесогав о! уоцг Яотат. 
СО дпаунсв 4 1095 - 
ОМб гесог5 йоситегуайоп СТ 
4 0м8 
сета 0М5 тападетеп! ог каоуаплеси 
бейтав Вемем, ада, апЯ ей ОМ гесогдз. ЕдИ5 УИ до (го ейест 
опсе замей. 
#2 Ема! ” я 
0М5 бешр: ЕО птропапа Ехроп то 3 Оавпроага ОБрау зешпдз: 
В ззитз - 
В Зеагсй ОМ5 Несогав 
ЩО весийу - 
| 77 Ай ПИег | олеляепа | | бевтен | 
9 Ассевв и 
Ф Зреед - Туре Мате Сомеп Ргоху зта!из ттъ АсЦопз 
8 сасмпа - СМАМЕ -#0981а7#9а7#994а3”7.. „“69е5565937906865а0724.. ОМ5 опу Ашо Еди» 
Фо могкегв пошев СМАМЕ Пепа епд-ар! а/оБшаг-ртегаподоп-Зудо?мо... -айъ“ Ргожед Ашо Еди» 
8 СМАМЕ 1епяепд-деу спатемегсе!-дп5.сот ад. Ргожед Ашо Еди» 
Вшез ”, 
СМАМЕ Гепзепа спатемегсе!-дпз.сот де: Ргохед Ашо Еда» 
ОФ мемьогк 
СМАМЕ зтогадеепяепа ЯЗоебатоупиибой.соца!гопи... а. 0мз опу Ашо вЗИ» 
тезеве - 
«  Сойарсе здеваг 


при ооо 


фиг. 4.15. - Сюиайаге на |епз!епа 


Платформата | епзГепа е вдигната на 5 места: 


- Мегсе!- за клиентския софтуер: ПИ рз/Лепяепа.каоуаплтесй 


2 Регвопа! (4) чегсесопукокозлестепзепа-потепа В (--) 
А 8 юкомесп ношу 2 Ф епаепа-помепа 3 Ееейраско Спапдеюд Неро Оосз 
Ргоес  ОПероутемз  Апаупсв  бреейпзамв  одв  З(огаде  Зейпдв 
|епаепд-Тгоптепа би: Веровкогу Оотайз 
Ргодисцоп Оерюутеп! Вий (096 Випите (095 


Тне дероутепи па: в амайаме 10 уошг Мзйогв. 


Оерюутепг 


Депс|епд-#гопгепа-гвпхвОхк!-кокостесй.мегсегарр 


ОПотатв 


(еп цепакаоуаплесп 7 +3 


Сгватей 1 


та адо ву Коковтесп #6 


Зташв 
9 Веаду 


Зоигсе 
49 па 
-0- 78Ь06св пегае(#66): аппосг тур. 


То ирдаге уоиг Ргодиспоп Оероутегц, риз то спе "тай" гапсн. 


фиг. 4.16. - Мегсе! на |епя!епа 


<О изхап Войбаск 


Геат Моге 


пе 2 


Ми: 
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- Негоки - за сървърния софтуер: ПИрз/Лепяепа-ар.каоуаплесп 


ПП) 4 регвопа! < Н дазпроага.пегоки.сопуврр5/епз!епа-арт В 


4» <асхгоге РаЧога 


НЕвОКИ Зитр #о Рауогйев, Аррз, Ргрейпез, брасез и: 2 


ОО гевопа! о >  епяепанар! Жо | орепарр Моге 9 


вини (С) КокозТесн/Теп51епд-Баскепа 


Омегмем  Везошсево Перюу  Мешсв Асбму “ Ассе5о бейпрз 


Мейс (а! 2415) АйМешсв Ф Гайезт аснуку АШдснуйу (9 


Невропзе Пте 


з ц 1 | що 


2 каоуапФкаюуаплесн: Оерюуей да11есе5 
Ееь 21 а: 12:41 АМ - у35 - Сотраге СМЕ 


Тнгочвйру+ 

<1гра каюуапекароуап.десн: Вий зиссеедед! 

д-д. 1 1 1 д е Еер 21 а(12:40 АМ - Мел Бийбпов 

Мепогу 

35 96 

е: 1 Ф каюуапфкаюуап.(есн: Пероуей 1007574 

+ Еер 15 а: 8:09 РМ - у34 - Согараге ИА 

Тозцайед айа-опв Сопйвиге Айб-опа 


каюуапекаоуапллесн: Вий зиссеедеа! 

ЕеЬ 15 а58:08 РМ - Мем Бийапов 
Тнеге аге по айд-опв Гог 5 арр 

Хоц сап айа ай9-0пз 1о #1 арр апа Неу уий зпом Пеге. Цеаг тоге каоуапокаоуапллесн: Оерюуей 6951097 

ЕеЬ 12 а:5:31 РМ: у33 - Сограге а 


>) 
ооо оо о 


каюуапекароуап.(есн: Вий зиссеедеа! 
Ее 12 а:5:30 РМ - Мел Бойс Пов 


Пупо оптпайоп ВАТ Сопйвиге Оупов 6) Х 


Тнв арр Б изпв базс дупоз 


Ф 2 каюуапекаюуаплдеси: Оероуей 45194сде 
+ Бер 7 22:50 РМ. у32 - Сограге ДИ 


прт зЖаг+ ом 


фиг. 4.17. - Негоки на | еп !епа 


- Домашен сървър на СМОЛ пих с ПосКкег за изпълнението на 


базите данни: ПИ рз///гпа!.каоуаплесп 


еое  Каюуапдоуснтоу - Каюуапбтай:- - - - з51 кайоуапбтай.каоуаплесн - 109х30 
+ 7 пеотетсп 
„-/+00888800+/-. КаТоуапбта11. КаТоуап.Тесп 
"1+888888888888888888+: ПЦ о------------------------- 
-+555588555555555555уу5555+- 05: ЦБипти 23.10 х86 64 
„оззззззззззззззззззамММНуз5з5о . Нозт: М5-7С52 1.0 
/зззззззззззлаттуМтту МММММИ 5 5 5555 / Кегпе!: 6.5.0-14-депег1с 
+ звзззвззззитуамммммммнададуз8555555+ ИрЕ те: 27 дауз, 6 Поигз, 1 тп 


/ взззззззпимммупнууууптмммммизззззззз / Раскадез: 1857 (дрКа), 9 (зпар) 
„ззззззззамМММизззззззззз ИММММз 5555555. 5пе11: 251 5.9 
+ зззз пипуМмММнуззззззззззззуММММуззз5зз5+ “ Тегтпа!: /деу/р+5/1 
озз уММММНуММИззз зззззззззззИттт!5 5555550 СРИ: АМО Кугеп 5 4500 (12) 0 4.208СН2 
озз уММММНМуММИиззззззззззззззИтттзззз 8550 СРИ: МУТОТА СеРогсе СТХ 1960 ЗСВ 
+ звззпппуммммуззззззззззззуММММузз555588+ “ Метогу: 6135М1В / 15870М1В 
„5зззззззамММмМиззззззззз 5 ПММММ5 5555555. 

/ взззззззпимммупиуууупамммммизззззззз / 

+ зззззззззату аммммммммададуз8555558+ 

/ вззззззззззлатмммитумммммиз 553 / 
„оз885ззззззззззззззамМММуззззо. 
-+855855855555з55з5ууу5555+- 
"1+8858858585885885885+:” 
.-/+00888800+/-. 


чр 


фиг. 418 - Информация за домашния“ СМО/ пих сървър 
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еое - Ккаоуапдоусптоу - Каоуапбта!:- -- - - з51 каоуапотай.каоуаплесн - 109х30 
+ « доскег р5 | агер "гед15" 
еба? д4ьасВ9е “| гей15/гей1з-зТасКк-зегуег:1аТтезт "/ептгуро1п+.вп" 8 иееКз адо Ир 3 меекз 
9.0.0.0:6380->6379/тср, :::6388->6379/1ср 
гей з-зТасК-зегуег 


+ « рза| --мегвтоп 
рза1 (Розтогезб) 15.5 (ЦБипти 15.5-диБиптид.23.10.1) 


» - 


фиг. 4.19. - Информация за Бед!в и Розгоге5 О на СМО/ пих сървъра 


-1е8- 


4.2. Инструкции за използване на системата 


421. Административна употреба в среда на разработчика - 


бууаддег / ОрепАР! документация 


След успешно стартиране на приложно-програмния интерфейс, 
административните органи или разработчици могат да достъпят онлайн 
документацията на ППИ на "р(5)/ДАПОВЕ55Уар". В тази документация 
на Ореп-АР! (5уухаддег) могат да разглеждат различните пътища на 
интерфейса, какви са им входните и изходните данни, както и да правят 


различни заявки с предварително попълнена информация. 


Зларвег 


Гепзепа 22 92 
питеринна 
Ашпопте а 

ивег г 
сет Детуиила аа 
| ет | Гар3/изет/те А вЕЗлв ам 
Г сет Дебунилални -- 
сет Дуебунилазинетння дуго 
(сет | ГарЗ/изег/те/вамей/рдасе а- 
сет Дрегунеуанна со 


фиг. 4.20. - Изглед на онлайн документацията Ореп-АР! 
Потребителят може да се регистрира или влезе също чрез подаване 


на заявки. 


беди уиечаеа аррисапопзоп. 


фиг. 4.21. - Отворена заявка и показани примери за входни и изходни данни, 


заедно с бутон за пускане на заявка 


-199- 


След което трябва да си въведе получените "ассез5" и "гейезй" 
токени на обозначените места (или главно място) с катинарче, за да 
потребителят да има достъп до защитени пътища или пътища, които 


изискват (дори опционална) авторизация. 


АуайПа е аинопгайопз 


Беагег (ПНр, Веагег) 


Уаше: 


ге гезп-тоКеп (Пр, Веагег) 


Маше: 


фиг. 4.22. - Въвеждане на Аийопгайоп токени 


422. > Клиентска употреба 


Началната страница е първата страница, която потребителя може да 
разгледа без дори да влиза в профила си. Идеята на приложението е да 
бъде достъпно дори и без създаване или влизане от потребителски 
профил. Това се отнася за най-простите му функционалности, като 
разглеждане на началната страница, категории, търсене, използване на 
карти и гледане на обяви и места. Потребителят трябва да е в акаунт, за 
да може да оценява, коментира, оставя ревюта или запазва места и обяви. 

В началната страница може да се разгледат най-новите места, обяви, 
потребители и тн. Освен това на нея има интерфейс за търсене на 
потребители, обяви и места, както и голям банер, който се за вътрешни 


реклами и обявления в приложения. За приложението има глобално 
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навигационно меню, което се показва на почти всички страници с 


изключение на няколко. 


Фо ПП зрегзопа 


ГО 1 Гепзепа 
Год Цепзьепа Приключване на Дипломните проекти 15.02.2024 г. 


График за предаване 16 - 22.02.2024 г. 
Възможност за удължаване до 22.02.2024 г. 


Финален срок за окончателно предаване 29.02.2024 г. 


зцПоокта Гого 


Гатез осайопв оп Пе тар 


р Зан 


Тесппооду зспоо! Пестопс 
бузетв 


Фо ПО зрегзопа! 


Го 1 гепзепа 


Го 1 Бепзепа Щ Расез | (65 Едшртеп 


В.“ мазев,оои - и вом 40,00 


» 
г: папкоумувеотва Каоуап ОСоусптоу Д А 
р 2: - 
| : 42 . 


4 
и: н 99 999,00 Е: сн/ 9999,00 


а Каоуап Поусптом Киз! Ра! 
+ 
нз в 
(вр. о Ае. иа 
ае ти Фотографско оборудване зиж всички > 
, а ро и 7 Ргодис! 


ко ВО 
Рпогодгарпу едшртеп! 


ОПепкоу Му Веоуей 
Ргодис: ро 1 1 бепкоу Му Веоуед ши У 


ми: 40,00 н99 999,00 па азао во 


Роршаг изегв 


Твуетета 
Ооусппоуа 


Ммкоау Оепком Каоуап Ооуситоу. Кози ре! Каюуап Ооусппоу Каюуап Ооусптоу 


фиг. 4.24. - Начален екран част 2-ра 


Ако потребителят желае да се регистрира може да отиде на 
регистрационната страница, като използва навигационното поле. 
Регистрацията е разделена на четири части - информация за акаунта, 


информация за профила, запознаване с условията за използване на 


54 < 


приложението и накрая потвърждаване на имейл адрес и телефонен 


номер. 


(О всатови:3000/56/аштувкапир. 


Го 1 ЦепзепЯ Регистрация 


ЕВ имейл адрес 


9, потребителско име 


В. парола 


А потвърди парола 


Напред > 


Вече имаш акаунт? Влез 


Год ГепзепЯ бюп Ир 


(А етай 

О, изетате 

Гат раззууога 

а сопйгт раззмгога 


Мехъ > 


Агеаду Паме ап ассоип!? Год п 


фиг. 4.25. - Първа стъпка от процеса за регистрация 


(О юсатозк:3000/ооуашту5юпор. 


Год ЦепзепЯ Регистрация 
2. име 

А. фамилия 

В 02/2372024 

4Ь телефон 


< Назад 


Вече имаш акаунт? Влез 


Го 1 Гепзепа Зюп Ир 
ЗА. Нгепате 
А. аз: пате 


ТАрг 2006 


Агеаду пауе ап ассоцп!? Год п 


фиг. 4.26. - Втора стъпка от процеса за регистрация 
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(О осайоз:3000/5о/вийузюпир. 


Год ЦепзепяЯ Регистрация 


фиг. 4.27. - Трета стъпка от процеса по регистрация 


След успешна регистрация идва и време за четвърта стъпка, която е 
незадължителна - потвърждаване на имейл и телефонен номер. След 


успешна регистрация, потребителят също така е влязъл в новия си акаунт. 


(О осайоз:3000/5о/зибувюпир. 


Год |ЦепзепЯ Регистрация гоц Гепзепа Зап Пр 
28 мегу ета! 
2Е0 уег!у етай са 
(са) 


(КА зепа уепйсаЦоп сойе. 


2Ей мепбу рпопе 


4Ъ бепд мейсацоп соде 
2 уег!у рпопе 


< Пропусни Завърши > 


А. бепа уепйсайоп соце 


< 5кр Ева > 


Агеаду Пауе ап ассоцп!? Год п 


фиг. 4.28. - Четвърта стъпка от процеса по регистрация. 
Както може да се забележи на всяка страница в процеса на 


регистрация, ако потребителят вече има регистрация, той може да 


влезне с вече съществуващия си акаунт. Такъв бутон също може да бъде 
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открит в навигационното поле на уеб приложението. След успешен вход, 


потребителят бива автоматично прехвърлен на началната страница на 


приложението. 


(О юсатоз:3000/5а/аит/одт. 


Год Цепзепа Вход 
пи 
Год ГепзепЯ Год т 


е етай айдгез5 


е раззмиога 


Еогдо: з5муога? Годт 


Аге уои пем Пеге? Зап ир! 


фиг. 4.29. - Екран за вход в потребителски профил 


След успешен вход, потребителският интерфейс се позапълва. 
Навигационното поле има много повече опции - за чат, за любими, за 
разглеждане на собствен профил, за настройки, за излизане и за 


създаване на съдържание в приложението. 


(Б) съобщения 


Ж Любими 


(а) Моят профил 


4» Настройки 


(6 Изход 


Създай 


фиг. 4.30. - Навигационни компоненти, достъпни само за влезли потребители 
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Първата страница, която ще бъде разгледана е профилната 
страница. В нея се съдържа списък от всички обяви и места на 


потребителя, както и с неговата частна и публична информация. 


89 ПП зегвопа! е (О юсатозе:3000/99/изепоготе. - 
Ол Гепзепа 
Сокаюуап 5 ПзПпа5 


Гол Гепзепа 


Зопу а6400 - опу 2400 
зпиЧег соит! + 2 рацепез 
( са , ; 


) (2) 
:. 4999,99 #8 п.5000,00 Каюуап Поустпоу. 


Каюуап Поусптоу 
Зопу аб400 - оу 2400 ДИОАЕ год Зопу аб400 - опу 2400 БА ОАЛЕВЕР ЕрсренА я 3 у 
зпиЧег сошп! + 2 рабепез со -- зпийег сошп! + 2 Байепез 


ко Ако Аеко Ан 
».|ч. 4999,00 съч . 4999,99 
зопу Гогет 


КА кокопа070аатай.сот: 
г. 5000,00 ня лв. 5000,00 
КО 359 89 497 5679 
СКкаоуапз расез 


- Е А 29 януари 2024 г. (6 Ечи РиБйс по 
е: гЕФ От | те реката 
? 11---< ) : (Ф Еай Рима:е по 
в я---- Г е. «++ Спапде Раввиога: 
||. Т 32 
1 


1) Оейете Ассоши 


им Каоуапакауаплесп 


КА) +359 89 497 5675 


фиг. 4.31. - Профилна страница на регистрирания потребител 


Друга подобна страница съществува в приложението за 
разглеждане на профилна страница, но за чужд потребител. На нея може 
да се преглеждат само публичните данни, но освен това, може да се 


оценяват потребителите. 


Во 
ГО Гепзепа 
0 0 тт - 
00 еп 99,00 е 0 ци 
т 
00 еца 40,00 е а 
е 
До 
Ба, +. Зу г ту тт 
9900 е И е 00.00 е а (Ъ +359 89 497 5675. 
а) 


агси. Рпазейи: е 5 ега Тиг 
акаоуа расе «З +359 89 497 5675 
Ф нестро Града 
1 и 


Ги „ЛЕСТРОННИ СИСТЕМИ Скаюуапх Пзипаз виж всички 


СИ ЩЕ е 


Зопу РХУ/-2280 


я : 
Зов. лв. 12 999,00 


фиг. 4.32. - Публична профилна страница на друг потребител 
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Ако има повече от 6 обяви или места, ще излезе бутон - „вижте 


всички“ / „мему а", който завежда потребителя на страница с всички 


публикации на дадения потребител. 


во ПО зРезога (Овеаоз:3000елизейсвоувои/вцодейитив 


Го Папайапа Скаюуапх Из па 
о; 


Зопу РХУ/-2280 у Зопу РХУ/-2150 


Пр. :ен12999,00 Е И .: :он5999,00 


щ Рапазотс НС-Х2 4К Ргодис! 
, 
2 | е , Е «| сен» 40,00 


Калоян Дойчинов 
с 
(а 
г вон 9999,00 


7 Мадегпаа 


фиг. 4.33. - Обяви на даден потребител 


Гол Гепзепа 


окаоуапхв Пз1паз 


Зопу РХУ/-2280 


лв а сааа е|п| 
бопу РХУ/-2150 
тв. еи (е || 
1 Репавотс Нс-х2 ак 
|. двовоо СЪ 


Ргодист 


е. 


со |) ле./ч. 40.00 е || 


Говорейки за обяви, екранът за обяви съдържа главна снимки, 


галерия от всички снимки, описание с тагове и времева информация, 


информация за потребителя и възможност за оценяване, локация, 


коментари и форма за публикуване на коментар. 


Фо (ПП) дрегвопа! (О осайтоз:3000/ег/вбпа/0!ой954-576с-4851-2078-Ва24а387384с 


Го 1епзепа 


ме: 


608 у Каоуап оусттоу 
< 


уу уа ту уг т 


ае ! Ф менргойе. ) 


12 999,00 


видна 
МАХАТ + 


ге д Гепзепа 


тъ / , 
2 9 Сподели " 


Зопу РХУ/-2280 ": 12999,00 


Майео Ново По договаряне 


фиг. 4.34. - Част първа от страницата на обява 
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- ог г + 
ат тт тт оттоит Гол Гепзепа 


Год Цепзепа / Щ вена г В +359 89 4975675 
к : 
Е в к: от е 1 


пруоп Тв |5 а тевипа дезспроп Тв |5 а тевипа дезсп 


2 Соттетв -1 


2 Коментара 


И Каоуап Ооусппоу 
т7 


<р с!аз5- Чех!-та у/пИезрасе-рге- 


фиг. 4.35. - Част втора от страницата на обява 


Всяка обява има 2 важни бутона за извършване на действие - 
запазване на пост и изпращане на съобщение. При запазването на даден 


пост, се отваря модал - изскачащ прозорец. 


Добавено в 


Вики с любими 


Тпе изипа паз бееп замед зиссезз!шу. 


а 


фиг. 4.36. - Изскачащ прозорец след запазване на публикация 


Обявата е добавена в любими 


Другият бутон е за изпращане съобщение до потребителя. Линкът е 
форматиран за изпращане на дадено 5М5 съобщение. Като след 


натискане в повечето модерни браузъри излиза изскачащ прозорец, 
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който пита потребителя за потвърждение, дали иска да бъде отворено 


тяхното приложение за изпращане на съобщения по подразбиране. 


(О осатозе3000/еп/випо/90/вабра-576с-4851-4078-Ва24а3873Вас. 


Орел "в71з:+350542089620497462056757Ь0б,-Нео, 620 т420итнегевгеф 20 1620уоцшгк20апа:»к202620бопукаоРХи!-22в0ж2онир192-168:.200:000/1па/20!е49Ь4-576с-4851-4076-8а24а387364с“ па пем (35. 


фиг. 4.37. - Изскачащ прозорец на браузъра след натискане на бутона за 


изпращане на съобщение 


Подобен на него бутон е този за повикване, който се намира в 
кутийката на потребителя. На картата, показана под потребителя също 


има и бутон за получаване на навигация в Соод/е Марз. След неговото 


натискане се отваря на нова страница (или в приложението, ако 


потребителят е с тел.) - Соод1е Марз с готов маршрут от текуща локация. 


< Фа в + х 
Ве 23та тмво звет 
Обоуа 
п Огоя. 
о | Уоиг осапоп 
Закеа : + 
В + Везд Скадез „5 Е 
езден редец 
О  къмайерпа, Вошекага "Вопеуогадвко оле ТИ сопкевойне 
> ме зосадаша Оицвет < (Владо Уаапйва 
десетия с | < | Н: смнеЕ Ябланица 
ФФ даачевчлацоп х Реагсн Кайпа и да СТАР 
и Петърч Кътина | ШТ бо 
ОБеа! > 
< Обединение 
Цеауе пом ОрЧопз Ковйовгов. са / 
г Бо Костинброд Без 
га реко Ер 
окогзко. 
23 ти тъ Токорско 
51 бепа 4гесцопв 10 уоигриопе  с2 Сорупак иногаскае - 
ъ2 | Виво! 
бо с “ Бухов 
е В мат? 23 тп БИ се | А ВЕР: 4 
Еав(ев! гоще пом дие1о та с. 249кт ооо Гурдазово 4 с Ц 
сопнопв я 2 А, 
|. я 
и Ивига га 
Оеай!5 Клисура БА А а И е, ку-Угаудерпа, Вошечага. < сага 
Байкя я! -"ВойвудгайвКо 5Позе--- “Збенгвотот ан бъз 
нов? < аз. + Долни Богров ста 
АВ Мабул. „Ботевградско шосе“ 28 пп га (а 1 828 па до 14 оз | 
15.1 Кт Кривина. 
1 Ваупо ройе Ейп Рей 
Да Равно поле. Елин Пе 
2 ( ш г Казичене 
ма Софийски околовръстен 29 пп боегб мудоо а 
а е тв да р вино га тр МЛАДОСТ. ш | пРен 
т! 29 олемо вдауа -- 
път/Коще 9.0 Ка Еслеца Нана ВИТОША да ра аа ага 
а 
Да па що "-Моинап 
Осен Цовеп, 81. Новихак 
. Драгичево ло Лоз 3 ма +, 
Ехрюге пеагру Ку. УгадеБпа, Вошеуага Н п # -ш 
Видагз! Ввийза. а + за 
"Войеудгайвко ЗНозе" 282-284 Рударци Бистрица“ Кокамапе ВО 
Каслиза. те Соосе > Кокаляне аа 5 
кл Веквнко. 9! Е а Кгизпоуне 
2 аре задна Вгап!вие. в < ие ае 
я оо - от  оож- о--- Ба зит Н 


фиг. 4.38. - Соод1е Марз навигация 
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Втората страница, която се намира в навигационното поле е тази за 
избор на категории и подкатегории. В нея са изброени всички категории 


и за обяви, и за места. 


Фо (ПП дрегвопа! (Ф) (О юсгйо5:3000/ег/сагедопев. 


Год Гепзепа 
Едшртеп! Расез 


Го; Гепзепа 


Аифо Са!ез Оборудване 


Рпотодгарну. онсе Айо 


Зопу Сатегаз 
Везтаишгат 


Арна Рпотодгарпу 
Зопу Сатегаз 


Арпа 


оМсе 


фиг. 4.39. - Екран със списък от категории 


При избиране на категория се отива на нова страница, в която са 
изброени обяви или места за дадената категория и нейните 
подкатегории. Тази страница също е разделена на страници и лимити 


(Радпапоп). Като контролите й са като на фиг. 4.53. 


Фо ПО зевопа е (О ссановез000/еплвцод/сайедогузаза-9БЬ-сссс-88а4 


Гол Гепзепа 


Рпотодгарпу 


Ргодис: + 
: | : | 
7 2 | 
Вт еее 40,00 2 


вен 99 999,00 , Ееда 
Каюуап Поусттпоу Калоян Дойчинов Е ново ! лв. / ч. 40,00 ав 
Са 
„ 9999,00 е | о| Еда 


“. ФЗаукт 


Год Гепзепа 


Оепкоу Му Веюуед Рпотодгарйу 


Ргодис: 


всн 9999,00 Оепкоу Му Веоуед 


ь- ь 7 
А 7 Мадегпаа 1 | аа 


„ земи 200,00 е (а 4 „2 вен 55,00 
я Каоуап Ооусптпоу 
7 Тез: Ирюад м 7 А шасез тез: ; 5 


е а | 74 бреваиа 2 ; лв. ч. 9999,00 е (а) 
С 


Тез: Прюай 3 Калоян Дойчинов 
и в 


вон/к 300,00 Е 
во лв. 9999,00 е|а| 


фиг. 4.40. - Страница с изброени елементи отдадена категория и нейни 


подкатегории. 
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Третата страница, спрямо навигационното поле, е търсачката на 
приложението. Тя може да се използва като глобална търсачка, като търси 


едновременно за всички елементи - места, обяви и потребители. 


Фо ПП дрегвопа (О осайоз:3000/егувеаген 


Год Цепзепа 


Гол Гепзепа 


Вееуап! расез 


Търси обяви, места и хора 


Е тъ 
Зтагрискв (а| зшдйю 4.2 Зразка АшотоБйе 
к ! мак вма 73, 1 пи зегизк! Коте в а. угавли 1 


Вееуап! ИзПпаз 


Тез: Ирюаа 


(2) 
и» 300,00 е а| вом 300,00 


Тез: Ирюай Огигпьа 7 74 птадез (ез! 
гажк.л а 5опа, Ви (в Ба 


Тез ироаЯ 3 


фиг. 4.41. - Изглед на търсачката, когато няма нищо потърсено 


или се използва като глобална търсачка 


Бутоните до полето за търсене са за филтриране на елемент за 


търсене - място, обява или потребител. Интерфейсите за определено 


търсене са с много страници и лимити (Рад паноп). 


СО саноз:з00едвезиен?веогсскаюузодениедогу-нтеейпсета 


Го 1 епзепа 
каоуап 


Кееуап! изегв 1о "каоуап" каюуап 


ан 


| 6, “Ал в, « 
Каюуап Ооусптоу Каюуап Ооусптоу 


- а 
7 
4 


4 


Каюуап Ооусптоу Каюуап Ооусптоу 


Твметета 
Поусптпоуа 


Подходящи потребители за "каоуап" 
Каюуап Ооусптоу Каюуап Ооусптоу 


л 
.- 
, 
р< 


х вт, « 
Каоуап Ооусптоу Кагоуап Ооусптоу. 


КБ РП Калоян Дойчинов Коб Ре Мкогау Оепкоу 


фиг. 4.42. - Търсене за определен елемент 
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Четвъртата страница от навигационното поле е тази за разглеждане 


и намиране на места. Идеята на страницата е да бъде визуална и затова 


тя е една голяма интерактивна карта, на която са показани всички места 


на дадено място с техните специални иконки. 


ЕО | з регвопа! 


ФФ овсонег ева 


Ве Санедопев 


ОА зоне 


ЩО Рисев 


Зу пнотев 


ФФ мугене 


(6) зепидв 


С вом 


УОЦИУАК. 
волуяк. 


(О юсайози:3000/ег/расез. 


ОРАОМЕНЕНА 


промишлена 8! 
ЗОНА ИЛИЯНЦИ 


Ку. веНкоуски 
кв. вЕНКОВС, 


овЕАНООУТВ! 
ОРЛАНДОВЦИ 


И една 
с 


мадегнда Новрка! 
МБАЛ Нодеидя 


Ммапопа! Райасе. 
Кацйапа - Оусва. 


ск 
ЗТАЕЦВНТЕ 
жк 


стРЕЛБИЩЕ 
закзтом 
кст 


бири 


ъ 
КНУА2НЕУО». 


Зошн а 
КАРПУЗИЦА идеи 


оузпаспиен! ВОУАМА 
Воузпасниет() 0 КВЕОЯбА 
ку УПОВнА 
КК ИТОША 
- 
а 


Мигеко 
Муз 


ЧЕПИНСКО: 
ШОСЕ. 


ОЕСАТНСОМ 
Родиуапе | Подуяне: 
Доклтйон подузи 


ку удзи. 
Сеуск! 

КВ. ВАСИЛ 
ЛЕВСКИ 


Агепа Зойа. 
двена Совия 


мгдрозт 1 
МЛАДОСТ 1 


войа. 
цегдайопа! 


меХИЗКА, 
нПЗ ИСКЪР. 


километър 


мсАООзТ, 
МЛАДОСТ 


Аск овугива 2, 
КК ДРУЖВА 2 


Оби. 


иа СИ Пете поризтейето, 


г за). парк: 


МАОЕРНОА ОВБАНООМТЕ 
НАДЕЖДА ОРЛАНДОВЦИ 
ц 
>: 
ЗВАЦНАИЗ Вш; 


укаус Българи; 


Ммасот Агепа 
Аврагипом 5гади 
Виваком Арена - 
Георги Аспарухов. 


д. Зегфика Сетег 


КВАЗНО ЗЕГО! 
КРАСНО СЕЛО 


Сердика център, летище Сон 


2 вео миву. 


ГЕО МИЛЕВ 


ЗоНа 200 


Востагис! 
Бусманци 
МАМАЗТИЯЗК 


ВОУАМА. 
КВ. БОЯНА 


МПТОЗНА 
ВИТОША 


ф 


а!еузк!Мопазтегу, 
рагалевскиманастир 


ьо Мапа, 


фиг. 4.43. - Разглеждане на карта с места 


Зоопарк София 


вт) 


СТУДЕНТСКИ 
ГРАД 


медоозт. 
МЛАДОСТ 


Зойа Вта Май! 
Чу София Ринг мол 


При събиране на повече места на дадено място, те се групират 


заедно в кръгче с число, което показва колко места са събрани на едно 


място, този метод се нарича “сСизтеппа" 


ПО дрегвопа! 


ФФ овсоивгГееа 


88 сапедопез: 


О,| беагсн 


ЩО рисев 


ВВ сев 


Зу енопев 


(6) мургопе 


4) зашодз 


С» Подош 


Д 
Е: пей 7. 
да Ч. сек 


Окепомо 
Дреново. 


1 

С 
Вездеп 
Безден 


овизиет 
Опицвет 


изка 
Аботиоие: СЪН, 
Апдомировци СПУВНИЧ 
Бр 
би 


Хавовпа 
Ялботина 


Решен. 
Петърч, 


ци: иабазко 
Храбърско 


Негакомо 
Хераково 


Завна 
обети и 
РМ ти 


(О осайоз:3000/егурасев. 


снрзоиа 
Чибговци 


С беоден. 
Градец 


ц 


Риоезл 
Пролеша: А 


каша. 
Кътина: 


Доброславци 


доло. 
3 тоа 


ври с воруяк. 


Бокурище 


Гуоназова. 


кивша 


Клисура вазюз 


ста мениа пано 
А Дивотино 


Каеъ до! 
Кралев дол! 


Уаватоизи 
Воджиповци 14 

Регтик. 
Перник 


Вашпоис 
Батановци 


сура 
Мо 


ДА 


Магуапа: 
Иваняне. 


зва 
„Вкодвя 


Рударци 
„Квдпиза. 
Кладница 


Вовпек. 


У1ТОЗНА 
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фиг. 4.44 - Отдалечен изглед на картата, с цел демонстриране на “Сизфеппа”" 
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При натискане на някоя иконка на място, то се отваря встрани, като 
стеснява главната карта за разглеждане. А ако приложението се използва 
от телефон, то мястото бива насложено над самата карта. На частта за 
място се показва информация като: главна снимка, галерия от 
изображения, иконка, наименование, местоположение в текст, категория, 
описание, тагове, услуги, времеви статистики и много други, които се 


показват при плъзгане „зсго!” надолу. 


(О кевновеюденрвенва 


фиг. 4.45. - Първа част от изглед на място 


Освен това са покани хората, посетили даденото място, топ три 
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фиг. 4.46. - Втора част от изглед на място 
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Ако се плъзне “зсго!” по-надолу може да се видят създателя и 
притежателя на мястото, ако има такъв. Както и ако потребителят е 
модератор, администратор или създател (притежател) може да види 


бутоните за извършване на модифициращи действия - изтриване или 


промяна на информацията, това също се отнася и за екрана на обяви. 
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фиг. 4.47 - Трета част от изглед на място 


При избиране на бутона за прочитане на всички ревюта, 


преминава на нова страница, която също е встрани, за прочитане 
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фиг. 4.48. - Изглед на ревюта 
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Освен интерактивната карта, съществува и екран за разглеждане на 
всички съществуващи места по страници с лимит (РадпаПоп), като се 


натисне бутона за виждане на всички места в началната страница. 


(О осайтоз:3000/ег/раселйвл. 
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фиг. 4.49. - Страница за гледане на всички места под формата на картичка 


Друга страница от навигационното поле е тази за настройките на 
приложението. В нея се съдържат две главни настройки - тази за 
избиране на език (български или английски), както и тази за избиране на 
тема (автоматична, светла или тъмна). Като тази информация се съхранява 
в локалното хранилище на уеб браузъра. 
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фиг. 4.50. - Екран за настройки на приложението 
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Страниците за създаване на съдържание (обяви или места) са 
защитени и не могат да биват достъпвани от нерегистрирани 
потребители. За създаване на обява има вход за заглавие, избиране на 
категория, видимост, състояние на продукта, избор на снимки (както и 
тяхната подредба с плъзгане (дгад-п-агор). Също включва описание, цена, 
тагове (по подобие на ХочТире), избор на локация, както и дали цената е 


за наем и дали може да се преговаря. 
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фиг. 4.51. - Страница за създаване на обява 


Таговете могат да се копират и поставят с бутона за копиране. Освен 
това те могат да бъдат изтривани както и тяхното „Х“ бутонче, така и с 


бутона за изтриване назад на клавиатурата „БасКврасе". 


фиг. 4.52. - Поле за добавяне на тагове за обява или място 
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валидация и обратна връзка на полетата и формата за клиентски и 


сървърни грешки. 
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фиг. 4.53. - Грешки при подаване на грешни данни 


Другата страница за създаване на съдържание е тази за създаване 
на място. В нея са изчезнали някои компоненти, но са се появили нови - 
за избиране на иконка на място (емоджи), както и за избиране на услуга 


от вече готов списък. 
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фиг. 4.54. - Страница за създаване на ново място с отворен прозорец за 


избиране на иконка на място 
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Освен промяна на езика (на български или на английски), 
приложението разполага и с опцията да се използва със светла или тъмна 
тема. Като също има функционалност и за автоматично сменяне на темите 


спрямо настройките на операционната система на потребителя. 
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фиг. 4.55. - Светла тема на потребителския интерфейс 
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Заключение 


В изготвената дипломна работа всички заложени изисквания за 
функционалности са покрити и основният проблем беше решен. Освен 
основните изисквания, системата беше надградена и с много други. 
Целта им е да предоставят на потребителите още > по-добро 
потребителско изживяване. 

Въпреки пълно изпълнение на изискванията на тази дипломна 
работа, има още много работа напред за развиване на този проект. За 
бъдещо развитие на платформата са > определени > следните 
функционалности: 

- Създаване на вътрешна чат система за комуникация между 
потребителите в платформата. 

- Свързване на профила в платформата с ОАйй - Соод/е, Арр!е, 
Еасероок и други популярни платформи. 

- Интегриране на опции за плащане по подобие на еВау - онлайн 
плащане чрез 54 Пре или наложен платеж 

- Създаване на администраторски панел, в който да се създават нови 
категории и услуги. Да има възможност за промяна и изтриване на 
списък от потребители, места или обяви. 

- Създаване на функционалност за промяна на информация за места от 
обикновени потребители (не администратори или модератори) с 
исторически преглед по подобие на Уикипедия. 

- Създаване на функционалност за подаване на сигнал за обява, място 
или потребител. 

- Интегриране на Пеер! в потребителския интерфейс или подобна 
технология за превеждане на заглавия и описания, спрямо езика на 


потребителя. 
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Използвана литература 
рИрзу/досз.пезЦя.согп/ 


рИрзу/пехЦв.ога/9осз 

ПИ рзу/мууууу.рпзгпао/Яосз/огпа 

ПИ рзу/деуейорег.гпога.ога)/ 

ПИ рз//геаст.деу/гетегепсе/геаст 

ПИ рзу/мууууу.розтагеза|.ога/досз 
рИрзу/пех-п-досзмегсе!арр/досз 
рИрзу/мва! а! НчБ.о/геаст-аоос1е-гпарз/досз 


ЛЕ рз://змугмегсе!|.а Яосз 


ри рзу/ахюз-АШр.сопудосе по 
ИИрзу//гойд.дем 


ЛИ рз://гед!5.о/9осз 


ПИ рзу/досз.амуз.агпагоп.согп/53/ 


ЛИ рз://демейорегв.аоос!е.согп/гпарз/досигпептаноп 


ри рзу/ЛаПмипасзв.соту/дося пзтананоп 


ПИ рзу//ааопзо.дем/Ооа/Пому-То-аепегате-депепсз-сТо5-мий - 
пезЦззмуадаег-422а 


НИ рз://айНиБ.согп/мегсе/пех в гее/сапагу/ехагпр!ез 


ЛИ рз://айчБ.сопу/пехтац 1 з/пехт-ац?П-ехагпар!е 


ПИ рзу/хегозоигсе.соп/пехЦз-аиПеписайоп-му!-ехтегпа!-ару 


ЛИ рв://оппсеКк"гапств.глефипл.согп/амуз-53-зегмепезз-гпаде-чир!оад- 


апа-ТЛиглбпа!-сгеапоп-66сТей98Ь3 


БЪЕрз//мумууууоцтире.согп/муат си? мзБСОгап?!КМЕейЦ - РБеаст конференция 
ИИрзу/зтаскометому.сопу/ацезпопз/ 7191774 О08/Пому-То-сПесК-Тог-го!ез-1п- 
пезЦз-ачага 
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- А Црз//уоши ре/МТсРгиВкрА?а< АО?ХСо2мб 0007 - различни 
типове генериране и изобразяване на страници (Мех б5) 


- А ре/Лаймипясзв.сога/Моа/ацштопланс-с!а55-зогупа-муйЙ-рге Шег 


- АЦря//аретоо5луебргоиятоп.сог/ 


- рирз//айлир.сопу/ПаскКуиез-9/П1-сПепт 


- рирзу//айлирсот/ПасКкиез-9Т-сПепт 

- рирзу//айрир.сот/КоКозТесп/зпаскометоуу 

- риряу//айлир.ссот/коКозТесп/ гпацпзй 

- рирзу//айрир.ссоту/КоКозТесп/ гпашпзт-огтепа 


- ДА ре//айлир.согпа/КокозтТесп/агарйисз 


ГО - Ащрз//ох.ра, други версии на платформата също могат да бъдат открити на следните 
адреси: ПЕЕрз///о(к.го, НИ рву//а!х.р!, А рз//а.иа, ПЕЕр5у//о!х.ръ 


" Базар.БГ - НЕрз//рагаг.ра 


" В сравнения с платформи като ОГХБад или последните дизайнерски тенденции в 
разработката на уеб приложение. Това не намалява по никакъв начин производителността и 
простотата в използването на приложението. 


» Проучване за предпочитание на платформа за онлайн продажби на стоки втора ръка от 
анонимни потребители на социалната мрежи Вейай - ПпИр//Ппушпй.соту/о/хра-рагагра-1, 
риру/Алуишй.сопуохра-Багагра-2 


» Метаинформация (от англ. - глета и оптаНоп) - допълнителна информация, която пояснява 
даден обект (напр. заглавие, описание, тагове и др. на обява) 


М НПТР(5) - Нурег Тех Тгапз бег Рготосо! (5есиге) - протокол, използван за предаване на 
хипертекстови документи, които позволяват изграждането на взаимосвързани 
информационни системи в интернет 


у! Муербоскет - протокол, който осигурява двупосочна, постоянна връзка между клиент и сървър 
по интернет, позволявайки обмен на данни в реално време. Често използван за чат системи в 
интернет, следене на акции, табла с времена и други. 


УГаВРС - рамка за междусървърна комуникация, разработена от Соод!е, която улеснява бързия 
обмен на данни между клиенти и сървъри използвайки НТТР/2 и протоколни буфери. 


ХбЕО - беагсП Епате Орипиганоп - процес на оптимизиране на уебсайтове за подобряване на 
тяхната видимост в резултатите на търсачките (Соод!е, Впа, ОискОискОо, Вгаме и други), с цел 
привличане на повече органичен (неплатен) трафик. 


х Статичен уебсайт - 5Тайс ММерзйе или За йсайу Сепегатед Ууерзте (Статично генериран 
уебсайт) 


5220- 


х Сървърен уебсайт - 5егмег-54е Ууерз(е или 5егмег Непдаегед Ууерзпе (Сървърно генериран или 
изобразен уебсайт) 


х! Сървърно-изобразени - зегуег-гепдегед 

хп Уеб приложение с една страница - Зпс!е Раде АррПсаноп или по-добре познато като 5БРА 

ху б5р - бегуег-54е Вепдеппа - сървърно генерирано (изобразено) съдържание / компонент 

х/ С5В - СПепт-5ае Вепдеппа - клиентско генерирано (изобразено) съдържание / компонент 

х Ар|-Сатеуау - (ППИ шлюз) управляващ слой, който действа като единна точка на вход за 


всички клиентски заявки към микроуслуги в заден план, осигурявайки маршрутизация, 
агрегация на данни и защита на интерфейсите. 


ХР АТМЕ- Аирзу//демеорег.глогШа.ога/еп-05/досз/МуеБ/нтмг 


хп Маркиращ език - глагкйомип - система от анотации на документ, която е синтактично 
различна от текста и указва какво да бъде оформлението на страницата 


хх 56 - Ирз//деуеорег.тога.ого/еп-05/досз/Муер/С55 


х Замабспр! (ЕСМА спри) - Аирз//деуеорег.тога.ого/еп-15/досз/Муерамазспр!# 


х4 Туребспр! - МЕрз/ЛууумулурезспрИапа.ога 


х4 еас5 - пирз//геасъдеу 


ха Мцев- МЕрз//уце|в.ога 


ху ех 5 - ПЕрв//пехув.ога 


ху рублоп - МЕЦрз/Луууму.ру оп. ога 


хм Срапао - ИЕЦрв/Лууумуапаоргоесъсога 


хм! Ехргевв25 - Иирз///ехргеза|5.сопа 


ХМ! Мез 25 - ПИрз//пезЦв.сопа 


хах МубОГ. - ЛИ рзу/Луууууу. плува .сога 


хк родрагеб Г - МЕЦрз//ууууму.розтагеза|ога 


хо вца! 5Еийо Сойе - Прз//содемвиа!зтияо.сога 


хо Зе Вгайпз Муербтогт - АШ рз/ЛууумуетБгайлз.сога/мерзтогт/ 


хоп рефакторинг - процес на модифициране и преструктуриране на код на даден софтуер, за да 
се подобри неговата структура, производителност и четимост, без да се променя неговата 
функционалност. 


хоу 2ед - рз//гед.деу 


е) - 


хху Перепдепсу песпоп - инжектиране на зависимости - дизайн модел, който позволява на 
класовете да получават своите зависимости отвън, вместо да ги създават самостоятелно. 


хол Анотирани - (О - употребата на декоратори за маркиране на класове, методи и свойства с 
метаданни. 


хо! ривгла ОКВМ - Ри рзу/Луууму.ризгплало/оггп 


хо" ОВМ - Офест-Вейапопа! Маррта - процес за свързване и управление на данни между 
обектно-ориентирани програмни езици и релационни бази данни. 


хок Ох - Пемеорег Ехрепепсе - подобно на потребителското изживяване, но в контекст на 
разработването на даден проект - от страна на разработчика. 


Х РУП Тех беагсй - техника за търсене в база данни, която позволява намирането на записи, 
съдържащци текст, базиран на съвпадение с даден термин или фраза, вместо на точно 
съответствие. 


х РОМ - Поситеп! Ощес: Моде! -е програмен интерфейс за НТМ! и ХМ! документи, който 
представя документа като структура от обекти (дърво). 


А Меморизация - техника за оптимизация на производителността, която запазва резултатите 
оттежки функции и ги използва отново при повтарящи се входни параметри. Така се избягват 
повтарящи се тежки изчисления. 


хт Ревалидация - процес, който позволява на приложенията да поддържат своите статично 
генерирани страници актуални, като се използва техниката на инкрементално статично 
регенериране (15Н). Т.е. извличане на данни през определен период от време или при 
случването на дадено събитие - тригер на таг (с Мех об 13+). 


ху Контекст - Веаст СоптехЕ- функционалност, предоставена от Веас 35, която позволява на 
данните да бъдат лесно споделяни между компонентите на уеб приложение без 
необходимостта да се подават свойства (ргорз) на дълбоки нива през всеки компонент от 
йерархия. 


хуМех-и! - АШрв//пех-п!-досзмегсеарр 


хм дмв.д/геаст-доод1е-тарв ПИрз//айлир.сопу/мвагеаст-аооа1е-гпарз 


ХМ соод/е-глар-геас! - МЕЦр5/Лмууму.пруз.согу/расКкаае/аоос/е-гпар-геаст 


хип СуУВ - риррз//вууг.мегсеарр 


хк Дхов - И ря//ахоз-НЪрр.сога 


25ОМ - пЕрзу/Луууууувоп.огазоп-еп. 1! 


Г72од - рз//год.дем 
ПОЗМУТ - Аире//мищо 
п Ведв - ПЕрз//гес!5.о 


м Апагоп АУМ5 53 - АШ рз//амув.апагоп.соту/53/ 


за - 


“СОНМ - мрежа от разпределени сървъри, която доставя уеб съдържание и други уеб ресурси 


м Соодй(е Марз Работ - ПШрз//гтпарзра огт.аоосе.сога 


м ТаймипаС55 - Мирз/Лаймипасяв.сого 


м! Табег 1сопв - Ирв/ЛаБепсопз.сопа 


кргешщег - НЕ рз//огешегмо 


хЕЗипЕ- А Щрзу//езиога 


х розвитап - МЕрз/Луумуму.роз пап.сога 


4 Пата - ирз/ЛуууууНаппа.сога 


2 Ой - АЩрз//ай-есг.сопа 


ху система за контрол на версиите - МС5 - Мегвоп Соп!го! бузтегп - софтуер, който управлява 
различни версии на документи, програмен код и други информационни обекти, позволявайки 
за следенето на историята на промените. 


х  ОЕНУБ - А ррз//айиб.сога 


хл УуакаТ ите - НИрз/Луака гпе.согп 


хо фрийланс (от англ. - > ееапсе) - работа на свободна практика - 
рърз//ралмкгоедга.ога/мк/Фрийлансър 


х Сепепс - Сепепс в Туребспрт! позволява дефинирането на компоненти, които могат да 
работят с различни типове данни, увеличавайки тяхната повторна употреба и гъвкавост. 


хх СВПО - означава буквално: създаване (Сгеате), четене (Веад), обновяване (Шряате) и 
изтриване (Ое!еге) - основни операции за работа с данни в бази данни. 


х радпатед - разделено на страници, метод за организиране на големи количества данни в 
удобни за преглед страници. 
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